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WELCOME TO 
GET STARTED 
WITH RASPBERRY PI! 


ou are holding, in your hands, a piece of history. 
This isn’t just a book about a computer: It’s a book 
with a computer. 

Not just any computer either. Raspberry Pi 3A+ is an 
incredibly well-designed microcomputer. And it’s part of 
the most creative computer family on Earth. 

With a Raspberry Pi, you can hack, make and build all 
kinds of different things. It could be a digital camera, ora 
retro games console, or a home media centre. Or a sensor on 
board the International Space Station, or a programmable 
Minecraft machine. 

Almost everything you need to get started witha 
Raspberry Pi computer is inside this kit, including a 
memory card for the operating system and storage. All you 
need to add is a USB keyboard and mouse, HDMI cable, and 
5V micro USB power supply (such as a phone charger). 

Our tutorials will guide you, step-by-step, from setting 
up Raspberry Pi 3A+ hardware to learning how to use the 
Raspbian operating system, through to hacking electronics 
with the GPIO pins on your Raspberry Pi 3A+. 


You’ ll also learn how to program a computer with Scratch x 
and Python, two of the world’s best programming languages. H 
We’re so glad you’ve got Get Started with Raspberry Pi D 
with the Official Starter Kit. Now let’s begin... i 
Lucy Hattersley 
Editor 
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06 GETTING STARTED 
Learn about Raspberry Pi 3A+ 


08 EQUIPMENT YOU'LL NEED 
What's required to get up and running 


10 SETUP YOUR RASPBERRY PI 3A+ 
Put it in its case and get it connected 


12 INSTALLING RASPBIAN 
Use your memory card to install the OS 


14 RASPBERRY PI STARTER GUIDE 
Explore the Raspbian desktop and more 


22 LEARN TO CODE 
Start programming with Scratch and Python 


34 GPIO ZERO 
Control the pins on your Raspberry Pi 


38 HOW TO USE A BREADBOARD 
Prototype electronic circuits 


40 MAKE WITH CODE 
Create electronic projects with Raspberry Pi 


50 RASPBERRY PI ACCESSORIES 
The best add-ons, HATs, and expansions 
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58 TV HAT 
Stream live TV from and to a Raspberry Pi 


60 SENSE HAT MP3 PLAYER 
Make your own music player 


64 CAMERA MODULE 
Set up and use a Raspberry Pi camera 


72 PICTURES FROM SPACE 
Receive radio signals from the ISS 


78 THE 50 BEST TIPS 
Master Raspberry Pi with these tricks 


88 BUILD A SAMBA FILE SERVER 
Share your files with other computers 


92 USE SSH 
Remotely control your Raspberry Pi 


96 SWITCH TO THE COMMAND LINE 
Discover the power of terminal commands 


102 INSIDE RASPBERRY PI 3A+ 
Behind the scenes with the team who built it 


110 SAFETY AND USER GUIDE 
Technical info for your Raspberry Pi 3A+ 
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FEATURE 


FQUIPMEN I 


The microSD card in your kit acts as the hard drive 
for your Raspberry Pi. After removing it from the SD 
adaptor, you install the Raspbian operating system 
onto the card, then all your documents, files, and 
projects are saved to it as you work. The microSD 
card in your Starter Kit is a high-quality piece 

of equipment and comes with NOOBS pre-installed. 

If you want to use a larger capacity card, take a look at 
the results from benchmark tests done by Raspberry Pi 
fan Jeff Geerling. Some cards run up to four times as fast 
as others. You can read more at magpi.cc/xZLRky. 
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NOOBS automates the 
process of installing 
Raspbian. Select the 
Raspbian option and 


click on Install to run it 
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The official operating system is the 
easiest to use, and the one beginners 
should start with. It works a lot like 
other popular operating systems. 


| 
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Not the full version of Windows, 
but Windows 10 loT Core enables 
programmers to run Internet of 
Things and embedded projects. 


Discover the internet of your things 


> E O 


Ubuntu is one of the world’s most 


popular Linux operating systems, and 
Ubuntu MATE is a lightweight version 
that runs just fine on the Raspberry Pi. 
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Raspberry Pi Configuration 


Need to adjust some settings? The To adjust the amount of memory for 
Raspberry Pi Configuration tool is the GPU or to set older Raspberry Pi 
in the Preferences section of the models to run faster (overclocking), 
applications menu. In its System tab, visit the Performance tab. 
you can change your password, adjust You can change the time zone, 
display options, and set Raspberry keyboard, and other geographic 
Pi to boot to the command-line options in the Localisation tab. 
interface (CLI) instead of the desktop. There are separate options in 

In the Interfaces tab, you can Preferences for configuring the 
enable connections, including appearance, audio, main menu, 
remote GPIO access andthe camera. mouse and keyboard, and screen. 


WO FEATURE 


Discover some of the software 
that comes with Raspbian, and 
find out how to install more 


installed software (which depends on 

which version you install), so you can start 
working, learning, and making things straight 
away. Ranging from productivity suites to games, 
you'll find a well-curated collection of software is 
just a click away, in the applications menu. There 
are lots more packages to browse and install, too. 


E aspbian comes with a selection of pre- 


ı LibreOffice Writer | OFFICE 
| No computer is complete without a word 
processor. LibreOffice Writer has all the 
font and formatting options you would expect, and 
has basic compatibility with Microsoft Word. 


N LibreOffice Calc | OFFICE 
Work out your budgets with this 
spreadsheet package. If you’re familiar 
with Microsoft Excel, you’ll feel at home here. 


LibreOffice Calc can open and use typical Excel files. 


oa LibreOffice Impress | OFFICE 
= If you’re presenting to a room of people, 
don’t panic: Impress has your back. Use 


it to craft and display your slide deck. It’s largely 
compatible with Microsoft PowerPoint. 


ve Chromium | INTERNET 
Chromium is the open-source version 
of Google Chrome. The default search 
engine in Raspbian is Duck Duck Go, which 
promises not to track you online. 


> Claws Mail | INTERNET 

A, Send and receive email. The setup wizard 
an helps you add your email account, and the 

streamlined interface shows you your mailboxes, 

message list, and a preview of the selected message. 


A VLC | SOUND & VIDEO 
bech Listen to music while you’ re coding using 
VLC, a fully featured media player for 
music and video. It can play digital files, streams, 
and physical media such as CDs and DVDs. 


ER Minecraft Pi | GAMES 
eet We callita game, but it’s more a way 


of life. With Minecraft Pi, you can build 
things in Creative mode, and write programs to 
change the (game) world. 


op Python Games | GAMES 
A These tea-break games are fun, but 
they’re also great Python demos. Find the 
code in the /usr/share/python_games folder, and 
open it in a Python editor to see how it works. 


SmartSim | PROGRAMMING 
is} Experiment with designing and testing 

digital logic circuits. You can develop 
custom components and then incorporate them 


into other circuits. Download examples and read 
tutorials at smartsim.org.uk. 


Sense HAT Emulator 
Le PROGRAMMING 

This emulator features on-screen 
controls to simulate temperature, pressure, 


humidity, and device position changes. A great way 
to try out the Sense HAT before you buy one! 


Updating your software 


Linux software comes in packages, 
which are compressed archives 
that you can download. A package 
manager is used to find and install 
them, including any other software 
they need to work. 
Use Add/Remove Software to 
update your packages. From the 
menu, choose Preferences > Add / Remove Software. Click on 
Options and Check for Updates. 
You can also update from Terminal. In Raspbian, the package 
manager is called APT. Updating all the software from the Terminal 


is a two-step process. First, KMSUdO apt-get updatepimMas 


Terminal to update the cache of available software. Then enter 

to update the software installed on Raspberry 
Pi. You’ll be told what changes will be made and asked to confirm by 
typing Y and pressing ENTER. 


Installing software 


The easiest way to manage software is to use the Add / Remove 
Software tool in the Preferences part of the applications menu. It 
provides a visual front-end for the package manager. 

You can click a category on the left to browse applications, or 
enter a keyword in the search box in the top-left to look for a 
particular application. Choose the applications you want to install 
by ticking the box beside them. Some packages require other 
packages to work properly, but the tool will take care of that for 
you. To remove an application, untick its box. When you’ve made 
your choices, click OK to install or remove your software. 


WO FEATURE 


Tip! 


connect to your Raspberry Pi from another 

device: Secure Shell (SSH) and Virtual 
Network Computing (VNC). Before you can use 
them, they need to be switched on in the Raspberry 
Pi Configuration settings. To do so, click the 
Interfaces tab, then enable SSH and/or VNC. 

Both approaches require you to know the IP 
address of your Raspberry Pi. The easiest way to find 
it is to hover the mouse pointer over the WiFi icon 
in the taskbar. Alternatively, click the Terminal icon 
and enter ifconfig. It will show you all your network 
connections. You’re looking for an IP address, which 
will be four numbers with a dot between them, 
like 198.51.100.0. You’ll find it beside ‘inet’, in the 
details for wlano if you’re using WiFi or in the etho 
summary if you’re plugged in to the network. 


T here are two technologies you can use to 


Using SSH 

SSH enables you to use the command line on 

your Raspberry Pi remotely, so it’s very handy for 
installing software and fixing configuration files. 
You can’t use SSH to run any applications that need 
the graphical desktop, though. 


System interfa Performance Localisation 
Came: Er © Disabled 
SSH ©) Enabled Disabled 

C + Enable 
Sp Enabled e Disable 
C Enable © Disable 
erial Por Enable e Disabled 
eria e 


Cancel OK 


A Enable SSH and VNC before you try to use them 


If your Raspberry Pi is up in a tree photographing nature, you don't 
want to climb up there just to update it. Log in remotely and take control 


The software for SSH is pre-installed on 
Linux, macOS, and Windows 10. Start by opening 
the command line. On a Mac, find it by typing 
‘Terminal’ into the Spotlight search. On Windows 
10, Use +R to open the Run dialog box, then 
type in cmd. 

Once you’ re in the command line, enter 
ssh pi@198.51.100.0, but replace the numbers 
with the IP address of your own Raspberry Pi 
device. The ‘pi’ bit is your username. 


m SSH enables you to use 
the command line on your 
Raspberry Pi remotely, so 
it's very handy Di 


The first time you connect to a device using SSH, 
you’ll see a warning that shows the ECDSA key 
for the device you’ re trying to connect to. You can 
(if you wish) validate that this is correct by using 
ssh-keygen -1 -f /etc/ssh/ssh_host_ecdsa_key.pub 
in the Raspberry Pi Terminal. But it’s usually OK to 
just type in yes and then press ENTER to confirm 
you want to connect. 

You’ll be asked to enter the password for your 
Raspberry Pi device. You won’t see the cursor move 
while you do this, so type on regardless. When you 
press ENTER, you’re in! You’ll see a Linux welcome 
message, the date and time of your last login, and 
then the Raspbian command prompt, waiting for 
instructions. When you’ve finished, enter exit to 
eave the SSH session. 

If you’re using an earlier version of Windows, 
download PuTTY from putty.org. Enter your 
Raspberry Pi’s IP address in the Host Name box, and 
click Open. Again, you’ll see a warning if this is your 
first connection, which you can safely dismiss. Log 
in as pi, and enter your password. Raspberry Pi is 
now at your command! 


A Using VNC Viewer to manage Raspberry Pi from an iPad 


Using VNC 
Virtual Network Computing (VNC) enables you to 
remotely access the Raspberry Pi desktop, so you 
can manage files and run software using it. Some 
people use VNC to share their keyboard, mouse, and 
monitor between a PC and Raspberry Pi. 
Raspbian includes VNC Server, which runs 
automatically in the background if you’ve enabled it 
in your settings. You’ll need to download and install 
VNC Viewer (magpi.cc/FuGnye) on the device you 
want to use to control Raspberry Pi. VNC Viewer is 
available for Windows, macOS, and Linux. There are 
also Android and iOS apps, so you can use VNC to 
control Raspberry Pi from a mobile device, although 
it’s rather fiddly without a real mouse and keyboard. 
Optionally, by creating a RealVNC account and 
registering your Raspberry Pi, you can then access it 
from anywhere in the world using VNC Viewer. 
When you start VNC Viewer, it’ll ask you to enter 
a VNC Server address. This is the IP address you 
noted when you ran ifconfig on your Raspberry Pi. 
The first time you connect to a device, VNC 
Viewer warns you that it has no record of 
connecting to this device before, and shows you the 
device’s signature and identification catchphrase. 
To verify you’ re connecting to the correct device, 
click the VNC icon on the right of the taskbar in 
Raspbian to see your device’s details. 
VNC Viewer prompts you to enter the username 
and password for the device you’re connecting to. 
You’ll then see your Raspbian desktop in the VNC 
Viewer window. You can now use your keyboard 
and mouse (or touchscreen on a mobile device) 
to control the Raspbian desktop, including using 
programs installed on Raspberry Pi. 


ve VNC Viewer - File Transfer 
To send files to VNC Server, click the Send files button, below. 


To fetch files from VNC Server, navigate to the VNC Server icon in the notification tray or 
status bar and select File Transfer from its shortcut menu. 


To change where files fetched to this computer are saved, use the Fetch files to drop-down 
list, below. 


Í Send files... Fetch files to: E Desktop 


At the top of VNC Viewer in the middle is a tiny 
toolbar. The File Transfer option enables you to easily 
copy files to Raspberry Pi. 


Connectivity Security 


Identity check] 
Connectio Litarung VNC Viar. 
EEN 
Come fer uam 
Cee up VNC Server 
Hae 
Catchphrase 
` Other ways te csanect 


Authentication 


Send files from Raspberry Pi using the File Transfer 
option in VNC Server in Raspbian. Use the three-bars 
menu (top-right) to find it. 


Tools 

Wed 10 Jul 2019 14:43 

pi: Hi there! Who's connected right now? 
pi (Local): just me, buddy 

Wed 10 Jul 2019 14:44 

pi: Did you manage to fix that bug? 

pi (Local): yes and no 

Wed 10 Jul 2019 14:45 

pi: what does that mean? 


pi (Local): well, | fixed the bug just fine. But the fix caused 
another one. So I'm trying to sort that out now. 


Wed 10 Jul 2019 14:49 
pi: hello 
Wed 10 Jul 2019 14:51 


pi: who just joined? 


Use the toolbar in VNC Viewer to start a chat 
session with anyone using the server (Raspberry Pi 
device) and anyone else connected to it remotely. 


WO FEATURE 


Tip! 


Raspberry Pi comes with everything 
you need to start programming 


in for a treat. Raspbian comes with several 

integrated development environments (IDEs) 
you can use to write your own programs, supporting 
languages that are friendly to use, and fun to tinker 
with. If you’re a veteran coder, you’ll find powerful 
IDEs are included to help you be productive, too. 


| f you’ve never programmed before, you’re 


Scratch 2 

LANGUAGE: SCRATCH 

With its friendly drag-and-drop commands and 

a library of sprites and sound effects, Scratch 
makes it simple to get started with coding. By 
minimising typing, and guiding you to sensible 
block combinations, it helps you to avoid common 
mistakes. Don’t be fooled by its accessibility, 
though: it’s a fully-fledged programming 
language, with plenty of potential. 


Thonny 

LANGUAGE: PYTHON 

Python is one of the most popular languages on 
Raspberry Pi, and Thonny is our favourite way to 
edit it. Ina single window it shows you your code, 
the shell, and your data (variables), so you can easily 
see what’s going on and fix any bugs that creep in. 


Sonic Pi ae EL nn LT 
LANGUAGE: SONIC H 
Learn how to 
compose and perform 
music with code! 
Sonic Pi incorporates 
synths, samples, and 
effects that you can 
control by writing programs using a language based 
on Ruby. You can develop and modify programs 
while the music plays, to perform live concerts or 
improvise at home. 


Node-RED 

LANGUAGE: JAVASCRIPT/NODE-RED 

Node-RED enables you to use a flowchart to program 
data flows for Internet of Things applications on 
Raspberry Pi. It uses JavaScript, the language of the 
web. Run the Node-RED console in Raspbian and 
then visit http://localhost:1880 in your browser to 
program it. For help, see nodered.org. 


Greenfoot a — aS 
LANGUAGE: JAVA = 
Java is one of the = 
world’s most popular =, 
programming SS 


languages. Greenfoot 
makes it easier to 
learn, by providing a friendly environment for 
building simple games. The editor incorporates 

a game world, and you add Java code to image 
objects to control their interactions. Find out more 
at greenfoot.org. 


Geany 

LANGUAGE: LOTS! 

If you’re looking for a lightweight but powerful 
IDE, try Geany. It supports many languages, 
including HTML, C, Java, PHP, JavaScript, and Perl. 
Its code auto-completion and syntax highlighting 
can help you code faster, and reduce errors. Our 
favourite feature? Code folding, used to show or 
hide logical chunks of code in a long program. 


The Official Raspberry 

Pi Beginner's Guide 

Available to buy in print and as a free PDF, 
this book shows you how to set up Raspberry 
Pi, and gets you started with programming 
it in Scratch and Python. It also covers the 
Sense HAT and Raspberry Pi Camera Module, 
with code examples you can build and tailor. 


magpi.cc/BGbook 


GPIO Zero Documentation 

See how easy it is to start programming your 
own electronics projects for Raspberry Pi. 
The documentation for GPIO Zero shows you 
how to connect up sensors, LEDs, motors, 
and more. With a bag of cheap components, 
you can start building your first circuits. 


rpf.io/gpiozero 


Hacking and 

Making in Minecraft 

Minecraft on Raspberry Piis a 
great way into the world of coding. 
This book, another in The MagPi 
Essentials series, shows you how to 
shape the world with Python code, 
use a connected LED as a treasure 
sensor, and use Sonic Pi and Node- 
RED together with Minecraft. 


magpi.cc/MCbook 


Raspbern 


Beginn d 
er 
How to use your 5 Guide 


Official Raspberry Pi 

Documentation 

The documentation provides concise user 
guides for Linux, Minecraft, Sonic Pi, Scratch, 
and Python. It’s also the place to go for 
advice on configuring Raspberry Pi, hardware 
specifications, and remote access tips. Useful 
for both beginners and power users. 


Computer 


rpf.io/docs 


Conquer the Command Line 

We publish a series of short books called The 
MagPi Essentials, and this one explains the 
Terminal, including using it for connecting 
disks, compiling software, and backing up. You 
can download all the books in the series, and 
past issues of The MagPi, at magpi.cc/issues. 


>. et spber ry Pi 


magpi.cc/CLibook 


Python Games 

Go behind the scenes of the Python games that 
come pre-installed in Raspbian with Al Sweigart’s 
free online book. It explains the program code for 
seven of the games in detail, and lets you study 
another four listings yourself. 


magpi.cc/RTfkvD 
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WITH | WITH SCRATCH & PYTHON. & 


AUTHOR 


FEATURE HER 


p24 START 
CODING WITH 
SCRATCH 
p27 CODE A 
QUIZ GAME 
WITH PYTHON 
= p30 MAKE AN 
LED TORCH 
L earning to code can be one of the most profound WITH PYTHON 


skills you will ever develop. With code, you can 
control a computer. You can get it to do things for you, 


and also control gizmos and other computers. Kick back and 
let your computer do all the work. p3l BUILD AN 
Sure, that’s cool. But coding is about more than that. It’s ELECTRONIC 


about understanding how computers work, and getting a 
better understanding of how technology - and the modern GAME 
world - works. It’s about breaking down problems into little 
bits and solving them. It’s an amazingly helpful life skill. 
That’s why it’s profound. 
On a more practical level, knowing just a little code can 
lead to better job opportunities; a little more can open up 
well-paid and fun jobs. It’s an impressive skill to put on 
your CV and anybody can do it. Anybody. 
Coding is a lot easier than you think. And putting the 
power of computing and digital making into the hands of 
people is what Raspberry Pi is all about. 
Raspberry Pi is ‘the little computer that could’, and 
you’re ‘the person who can’. Don’t worry: you’ve got 
this. We can help you get started. 


M Raspberry Pi is ‘the little 
computer that could’, and you're 
‘the person who can’ D 
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FEATURE 


Start coding 


Beginners, arise! It's time to take your first steps with 
coding, as we introduce you to Scratch and Python, with 


eing able to write programs is like a superpower: 
it means you can get your computer to do 
whatever you want. Join us as we show you 
how to make your first programs using Scratch and 
Python. You’ll also see how easy it is to build simple 
electronics projects. 

A program is just a set of instructions. In Scratch, 
the instructions are written with visual blocks that 
lock together to make a sequence called a script. 
The blocks are colour-coded to help you find 

them. To find the brown blocks, for example, 
click the brown Events button above the 
Blocks Palette. 
Scratch makes coding easier, because you 
don’t need to worry about the spelling of 
commands. And everything is laid out in 
front of you. 


The Scratch screen is divided into units called 
steps. When the cat moves 10 steps, it only makes 
one movement, but that stride shifts it 10 positions 
across the Stage. The middle of the Stage is at 
x=0, y=0. The x-axis (left to right) runs from -240 
to +240, and the y-axis (bottom to top) runs from 
-180 to +180. The directions the sprite can move 
in are numbered 0 (up), 90 (right), 180 or -180 
(down), and -90 (left). You can use numbers in 
between those numbers too, so -45 would be a 
north-west direction. Why not try starting a new 


project and joining some Motion blocks together 
to experiment? You can run a script or a block by 
clicking it, or use the when flag clicked block as 
we did in our program here. 


a sprinkling of twinkling LEDs! By Sean McManus 


01 Start Scratch 2 
Open Scratch by clicking on the Raspberry Pi 
Menu icon and choosing Programming > Scratch 2. 
You will see Scratch interface and a single 
character in the top-left, known as ‘Scratch Cat’. 

To control the Scratch Cat, we’re going to drag 
blocks from the Blocks Palette into the Scripts Area 
and join them together. 

Start by clicking on Events and drag the 
when _ clicked) block to the Scripts Area. 

Now click on Motion and drag a 
point in direction 90 block and connect it the to 
the bottom of the (When clicked) block. 

Click on the fields in the blocks to edit the 
numbers. Click on ‘90’ and change it to ‘o’. 

Now click and drag the blocks below, and edit 
their numbers, to build a script for Scratch Cat. 
This script runs when you click the green flag 
above the Stage. It sets the cat’s movement 
direction to up, puts the cat in the top-left corner 
of the Stage, and sets it to always face left or right. 
Then, the movement blocks inside the (forever 
bracket keep the cat moving all the time. 

Click the green flag to run your script. Scratch 
Cat will move to the left side and bounce up 
and down. 


mene © Filev Edity ALEXE 


Blocks Palette: Find 
instruction blocks here 


Scripts Area: Drag and 
drop blocks here to build 
your script (program) 


Buttons: Click to view 
different types of blocks in 
the Blocks Palette below 


Sprite List: Select and 
manage sprites here 


02 Send a broadcast Click the Bananas sprite to add it to the Sprite 3 
The moving objects in Scratch, including List. Notice that its Scripts Area is blank. We’ll Top Ti p 
the cat, are called sprites. One sprite can send a give Bananas two scripts. The first one sets the 
message to all the other sprites using a broadcast. sprite’s size and makes it invisible when you click Get the 
You can’t hear it or see it on screen, but sprites the green flag. The second runs when the cat right sprite 
can listen for it, and then start a script when they broadcasts its fire message. Click and drag the 
receive it. We’ll use a broadcast to make the cat blocks below to the Scripts Area. Mels sure youle 


adding scripts to 
the correct sprite. 
You can select a 
sprite by clicking 
it in the Sprite List. 


throw some bananas. Click the brown Events 
button, and add the two blocks below to the Scripts 
Area. This new script doesn’t join to the existing 
script (from Step 1) - it sits on its own in the same 
Scripts Area. 

You need to change ‘message?’ to ‘fire’. Click 
the down arrow next to ‘message1’ in the broadcast 
block and choose New Message. Enter the message 
name ‘fire’ and click OK. 

As the program is running, when you tap SPACE, 
the broadcast message is sent silently. Crafty! 


when I receive fire 


50 


when space key pressed 


broadcast fire 


When adding the lid block, drag the 
block inside the round ‘y:’ field to 
replace the ‘10’ default value. 

The ‘fire’ broadcast makes the bananas jump 


03 Add aerodynamic bananas to the cat (use the go to mouse-pointer block, 
Scratch enables you to get results fast and choose Catı in its menu). Then it makes the 

because it includes its own images and sounds. bananas visible, glides them across the screen, and 

Click the first New Sprite button above the Sprite hides them again. 

List (it will display ‘Choose sprite from library’ as Click the green flag, and tap SPACE to test. 

you hover over it). Scratch Cat now throws bananas. 
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Top Tip 


Blocks inside 
blocks 


Some blocks can 
go inside other 
blocks. In Step 3, 
the y position 
block keeps the 
sprite’s y position 
the same while 
its x position 
changes. 


when 


wait 30, secs 


stop all 


clicked 


to D 


when 


set score 


04 Add monkey magic 

Variables are names used to remember 
information, such as a score, that might change. 
Click the Data button and click Make a Variable. 
Give it the name ‘score’, select For All Sprites, and 
click OK. Let’s add a moving target for the cat to try 
to hit. Click the ‘Choose sprite from library’ icon 
and choose the Monkey2. Select Monkey2 in the 
Sprites area and give it the script above. 

The monkey’s script sets the new score variable 
to o when the game starts, then makes the monkey 
move up and down. Each sprite can have more 

than one image: the Next Costume block cycles 
through them, creating an animation. 


05 Add collision detection 
Our monkey will react when it’s 
struck by a bunch of bananas. To do that, 
we use an fif) block; this checks whether 


clicked 


We're huge fans of Scratch at The MagPi, so 
check out our past issues online for more Scratch 
tutorials. Issue 5 includes a memory game, like 
Simple Brian. Issue 34 has a multiple-choice quiz, 


and our 2018 Annual included an introduction 
to electronics and Scratch. See issue 76 for 
a roundup of resources to help you learn 
Scratch, and don't forget there's a Scratch book 
in The MagPi’s own Essentials series 
(magpi.cc/learnscratch) and the Code Club Book 
of Scratch (magpi.cc/ccbook1). 


change score 


E 


wait E secs 


something is true - in this case, whether the 
monkey is touching the bananas. If so, the blocks 
inside its bracket are run. Here, those blocks 
hide the monkey, add 1 to the score, and wait one 
second before showing the monkey again. 

This whole code chunk goes inside the monkey’s 
forever) bracket - below the next costume block 
- so the program keeps checking whether the 
monkey has been hit. 


06 Finishing touches 

Let’s add a simple timer to stop the sprites 
moving after 30 seconds, and make the monkey 
react when it sees incoming bananas. Add these 
two scripts to the monkey sprite. Now the game is 
complete, why not try experimenting with it? Can 
you make the monkey move erratically instead of 
disappearing when it’s hit? Can you change the 
sprites’ positions and directions to turn the game 
sideways, making it more like Space Invaders? 
What about adding more targets to hit? One of the 
best ways to learn to code is by experimenting with 
existing programs. 


FEATURE WW 


Code a quiz game 


Make your own text quiz game that mangles famous 
phrases using the Python language 


any people progress from Scratch Thonny - /home/pi/190417 only connect py @ 39:47 e 
to Python, a programming language 
that is powerful, easy to get started 
with, and much easier to read and write than 
other languages. 

We’re going to make a simple quiz question 
generator that strips the vowels and shuffles the 
spaces in a phrase. The player has to work out what 
that phrase is. 

We’ll be using Thonny, which provides a 
friendly single-screen environment for running 
and testing Python code. Like Scratch, the Thonny 
IDE (integrated development environment) comes 
pre-installed in the Raspbian with Desktop and 


Recommended Software operating system. 


01 Create a list of questions 
As well as variables, Python has lists, which 
can store multiple pieces of information. Our 
program creates a list called questions. Each item 


in the list is a piece of text, known as a string. In Python, strings are surrounded by double quotes en, Type in and edit 
to show where they start and end. The whole list is YOU POLER 
A code here 
enclosed in square brackets, and there are commas 
between the list items. Type in the code below, save 62) Enter direct 
r S commands and 
your program, and then click Run. If it worked, you see program input 
should see no error messages in the Shell window. in the Shell here 
03 Keep track of the 
i : h import random data your program 
Python uses indentation to show which is processing here 
instructions belong to a function, an if statement, A ? 
or a repeating section. As you can see in Step 3 questions ` ["As You Like It", 
(overleaf), you can have multiple levels of "The Tempest", "Measure for Measure", 
indentation. The last line belongs to the if "Much Ado About Nothing", You'll Need 
instruction, and that is repeated inside the for "The Comedy of Errors", 


loop. The best way to get the indentation right is "King Lear", "Cymbeline", Raspbian with 


to remember the colon at the end of the previous i 
R "Hamlet", "Coriolanus", "Othello", peer op and 


line. Then, Thonny will add the indentation for you x d S Recommended 
automatically. If you forget, use four spaces at the Love's Labour's Lost", Software 
start of the line to insert the indentation. You'll still "King John", "Julius Caesar", Thorny 


need to fix that missing colon, though! "Edward III"] 
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Where next? 


You can find Python code to dissect in most issues 
of The MagPi. Issue 53 (magpi.cc/53) includes 


TopTip è 


Pesky 
punctuation! 


Take care to 
add the colons 
at the end of 
the if and else 
instructions. The 
code won't work 
without them. 


Pick a random question 

Python includes modules of prewritten 
code you can use, such as the random module 
we imported in Step 1. The first new instruction 
creates a new variable called chosen_phrase and 
puts a randomly chosen question into it. The 
second line converts the chosen_phrase to upper 
case. Run the program a few times and look at the 
value of chosen_phrase in the Variables pane. You 
should see different names come up, although 
names can also repeat. 

Add a line of space between the code in Step 1 

and add the following code: 


chosen_phrase 
chosen_phrase 


random. choice(questions) 
chosen_phrase.upper() 


Strip the vowels and spaces 
Let’s create a new list of forbidden 
characters, chiefly the vowels, but also the 
space and the apostrophe. That last list item in 
the vowels list is an apostrophe inside double 
quotes. We create an empty string variable, called 
puzzle. We’re going to go through each letter in 
the phrase, check whether it’s in the vowels list, 
and if not, add it to the end of the puzzle string. 
The for instruction sets up a repeating piece 
of code, called a loop. The instructions that 
should be repeated are indented from left. Each 
time around the loop, the variable letter is 
set to contain the next character from the 
chosen_phrase string. The if instruction 
checks whether the letter is in the vowels 


Debugging in Thonny 


You can step through the program slowly to see 
what it's doing, which can help you to find errors. 
Click the Debug button in Thonny, then click the 
Over button to run through each instruction in turn. 
Watch the Variables pane on the right to see how 
the lists and strings change at each stage of the 
program. Thonny also helps you avoid errors by 


highlighting unclosed brackets and double quotes. 


a more in-depth beginner's guide to Python, 
covering variables, looping with while and for, 
branching with if, and functions, which we'll 
cover shortly in this guide. Issue 54 (magpi.cc/53) 
introduces object-oriented programming in both 
Scratch and Python. Issue 73 (magpi.cc/73) 
includes a roundup of Python books and online 


resources. There is a book in our Essentials 
series too, called Make Games with Python 
(magpi.cc/gameswithpython). 


list. If it is not, the letter is added to the end of 
puzzle. The += means ‘add at the end’. Run the 
program, then test it’s working by looking at the 
contents of puzzle in the Variables panel. It should 
contain no vowels, spaces, or apostrophes. 

Add the following code to the program: 


vowels [ A 3 A 3 3 3 ] 
puzzle 
letter chosen_phrase: 
letter vowels: 
puzzle letter 


Insert random spaces 

Each character in the string can be referred 
to by its position number, starting at 0. The number 
is called an index, and you put it in square brackets 
after the string. Try this in the Shell (click on the 
line starting with ‘>>>’). Instructions in the Shell 
are carried out immediately. Enter the following: 


print( ap) 


You get ‘e’ back (because the first character is 
number 0). You can get a chunk too (called a slice) 
by giving a start and end index, like this: 
print( [1:4]) 
It gives you ‘ell’ because the last index position 
(4) is left out. We’ll create a new list, called 
puzzle_with_spaces, by adding chunks of the 
puzzle string and a space until there’s no puzzle 
string left. The while loop repeats the indented 
instructions below as long as the length of puzzle 
is more than o. The group_length variable is 
given a random whole number (integer) from 
1to 5. Then that many letters are added 
to puzzle_with_spaces from the front of 
puzzle, plus a space. Those characters are 


Python is easy to get started 
with and much easier to read and 
write than other languages 


then cut off the front of puzzle. The slicing here 
only uses one number, so the other one is assumed 
to be the start or end of the string. 

Add this code to your program: 


puzzle_with_spaces ` 


while len(puzzle) > @: 
group_length ` random.randint(1,5) 
puzzle_with_spaces = 
puzzle[:group_length]  " " 
puzzle — puzzle[group_length: ] 


Add collision detection 

It prints the puzzle_with_spaces. It then 
uses the input() function to ask you what your 
guess is. Your answer goes into the guess variable, 
and is then converted to upper case to make sure 
it matches the correct answer if it’s right. The 
if instruction checks whether guess is the same 
as chosen_phrase. If so, it prints one message. 
Otherwise, the instruction indented under else 
runs, to tell you the right answer. In Python, one = 
is used to put a value into a variable, but two (== 
are used to compare items in an if instruction. 

Add this code to the end of the program: 


print(puzzle_with_spaces) 
guess - input("What is your guess? ") 
guess — guess.upper() 


=` guess  chosen_phrase: 
print("That's correct!") 
else: 
print("No. The answer is 


, chosen_phrase) 


Click the Run button and hopefully you’ll see some 
letters in the Shell and ‘What is your guess? Enter 
an answer and you’ll see ‘That’s correct!’ or ‘No. 
The answer is’ and the correct response. 

If you’ve typed the code out by hand, it’s likely 
that you’ll see an error message. Go through your 
code line-by-line and compare it to the full code 
in quiz_game.py. 


quiz_game.py 


Language: Python 


003. 


0084. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 


magpi.cc/github82 


import random 


questions = ["As You Like It", "The Tempest", 

"Measure for Measure", "Much Ado About Nothing", 

"The Comedy of Errors", "King Lear", "Cymbeline", 
"Hamlet", "Coriolanus", "Othello","Love's Labour's Lost", 
"King John", "Julius Caesar", "Edward III"] 


chosen_phrase - random.choice(questions) 
chosen_phrase = chosen_phrase.upper() 


vowels = ["A", "E", "I", "o", "u", nn, men] 
puzzle = "" 


tor letter in chosen_phrase: 
if not letter in vowels: 
puzzle +- letter 


puzzle with_spaces = 


while len(puzzle) > ð: 
group_length - random.randint(1,5) 
puzzle with_spaces += puzzle[:group_length] + 
puzzle = puzzle[group_length: ] 


print(puzzle_with_spaces) 
guess = input("What is your guess? ") 
guess = guess.upper() 


if guess == chosen_phrase: 
print("That's correct!") 
else: 
print("No. The answer is 


, chosen_phrase) 
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SG FEATURE 


Build an LED torch 
and electronic game 


Discover how easy it can be to get lights blinking and buttons clicking using 


that you can easily hook up your own electronics 
projects. Using some electronics components and 
the GPIO Zero library, you can program a puzzle game 
where you have to repeat a sequence of lights that 
gets longer each turn. You might remember a similar 
electronic game from your childhood, but we call ours 
Simple Brian. In The MagPi issue 77 (magpi.cc/77) 
we showed how to use Python code to play the game 
on screen. Here, wel show you how to make the 
electronic game itself, building on your new-found 
Python skills from Missing Vowels. 
First, we’re going to show you how to build a 
torch by lighting up LEDs. Let’s get going. 


0 ne of the best things about the Raspberry Pi is 


Connect your first button 
The torch circuit diagram (Figure 1) 
shows an LED light connected to the GPIO 
pins of a Raspberry Pi using a breadboard 
(see magpi.cc/breadboard for a primer 
on using this piece of equipment). 
Press the button into the board, 
then use jumper wires to form a 
circuit with your Pi, as shown by 


| You’ll Need 


> 4x LEDs (ideally 
different colours) 


> 4x 330Q resistors 


> 4x 6mm Tactile 
momentary 
button switches 


> 400-point 
breadboard 


> 9 x Male-to-female 


jumper cables The online documentation for GPIO Zero 


(magpi.cc/DPyuYc) provides more code 
examples, including a button-controlled camera, 
an LED bar graph, and a motion sensor. We 
surveyed useful resources for basic electronics 
in issue 77, and there's a book in our Essentials 
series called Simple Electronics with GPIO Zero 
(magpi.cc/gpio-zero). 


> 8x Male-to-male 
Jumper cables 


> PiBow case with 
Breadboard Base 
pimoroni.com 
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GPIO Zero and use your new-found skills to build an electronic game 


the yellow wires in the diagram. The first button 
connects to the GPIO 2 pin on one side, and to 
the ground rail on the other side. We’ll connect 
the latter to a ground pin on the Pi, so anything 
plugged in that row of holes connects to ground. 


Connect your first LED 

Always use a resistor when you connect an 
LED to your Pi, to prevent the LED drawing too 
much current and getting damaged. Both the LED 
and the resistor plug straight into your breadboard. 
The current flows from GPIO 18, through the 
resistor, through the LED (lighting it up), to the 
breadboard’s ground rail. LEDs only work one way 
around: the short leg is the negative side, which 
you connect to ground. The LED won’t light up yet. 


Make an LED torch 

You’ve made your first circuit! Let’s test it 
by coding a torch. The torch.py code shows how to 
use an LED and a button. It imports the relevant 
parts of the GPIO Zero library, then sets up an LED 
called light, connected to GPIO pin 18. The button 
on pin 2 is set up with the name button. The while 
True loop checks whether the button is pressed 
forever. If so, the light is turned on. Otherwise, it’s 
turned off. Pay attention to the capitalisation of 
LED and Button when setting them up. 


Add the other buttons and LEDs 

Take a look at Figure 2 (overleaf). It looks 

complex at first, but the other three buttons 
and LEDs are connected in the same way as 


A The finished game, with all the lights lit up for testing 


the first ones, just using different pins on the Pi. 
All the buttons (yellow wires) connect to the Pi’s 
inner row of pins, and the LEDs (blue wires) to the 
outermost row. We’ve separated the components 
in this diagram a bit so it’s easier to see how to 
wire it up, but try to line up your LEDs and buttons 
on the breadboard so it’s easier to play the game. 


Test them all 

Now you can test these LEDs and buttons 
too. Modify your torch code to use LED(23) and 
Button(3) and then run the program to test the 
next light switch works. Then check LED(24) and 
Button(4), and finally LED(25) and Button(17). The 
buttons should be next to the LED they illuminate. 


Build an electronic game 

Now we’re ready to start making the Simple 
Brian game (see brian.py). This starts by setting up 
a list of buttons, and a list of their associated LEDs. 
It also creates an empty list called sequence, which 
we’ll use for the sequence of lights the player must 
repeat. With each turn, it'll get longer. 


Add functions 

Functions enable you to bundle up a set of 
instructions so you can reuse them. You have to 
define a function before you can use it. To define 
a function, you use def, followed by the function 
name, (), and a colon. The brackets are there to hold 
any info you’re sending to the function, but we don’t 
need to send any so they’re empty. You can tell 
which instructions belong to a function, as they’re 
indented. The lights_on() and lights_off() 
functions use a loop to go through all the items in 


CSI (CAMERA) 


43NN3HL3 


orpny 


Count the pins to see where to connect 
your wires 


The breadboard makes it easy to plug in 
components and quickly set up circuits 


Using this simple circuit (with an LED and a 
button), you can make a push-button torch 


torch.py 


Language: Python 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 


# Torch demo 


from gpiozero import Button, LED 


light = LED(18) 
button = Button(2) 


while True: 


if button.is_pressed: 


light.on() 
else: 
light.off() 


SLOZ Id Auuaqdsey 3 
TLA g IPPON E Id Aussadsen 


CAVISIC) ISC 


magpi.cc/github82 
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Just like its famous namesake, our Simple Brian 
game features four LED lights that flash up a 
sequence for you to memorise 


o The circuit also contains four buttons. We'll 
push these to repeat the sequence of lights that 
we've memorised 


03 At the heart of our project is the Raspberry Pi. 
The buttons and lights are connected to our 
computer with wires. Code in the computer 
flashes the lights and keeps an eye on the 
buttons were pushing 


A Ona breadboard, the rails along the 
edges are connected in a long line, 
and the short lines of dots in the 
middle are connected to each other 


the leds list, putting them into led, then turning 
led on or off. The flash_all() function shows how 
to repeat a set number of times, in this case 3. The 
loop turns the lights on and off, with a 0.25 second 
pause after each change using sleep(@.25). 


Lights test flash all 

After you’ve entered the functions (down 
to line 23), you can test the program by adding 
flash_all() as the last line and then running it. 
All the lights should flash together, three times. 
Delete that test line before you carry on. In line 
25, the program runs the lights_off() function to 
ensure the lights are all off before the game begins. 


Add to the sequence 

Now we enter the main game loop, under 
while True (line 27). Everything from here on in is 
indented to show it belongs to that loop, repeating 
endlessly. The game sequence starts as an empty 
list, so the first thing we do is to add an LED. We 
pick a random LED using random. choice() and 
add it to the end of the sequence list using the 
append() list method. A list method is a built-in 
Python function that you can apply to a list. Other 
methods are available to insert and remove items, 
and sort the list, among other things. 


Play the list sequence 

The lights all flash three times using the 
flash_all() function before the sequence begins, 
to show this is the start of the sequence. Then a 
loop is used that takes each LED from the sequence 
list, and puts it into light, in turn. It’s turned on, 
there’s a short pause, then it’s turned off. There’s 
another short pause so it’s obvious there are 
multiple flashes of the same light if it repeats in the 
sequence. In round one, there’s only one light in 
the sequence list, but as the game progresses, this 
loop will get longer. You can run the program at this 
point to see the light sequence gradually extend, 
without the player getting a chance to guess. 


Get the player’s guess 
Getting the player’s guess uses a similar 
loop to the one that plays the lights sequence. It 


brian.py 


Language: Python 


@@8. sequence = [] 


magpi.cc/github82 


081. from gpiozero import Button, LED 034. 

082. from time import sleep 035. # play the sequence 

083. import random 036. for light in sequence: 

004. 037. light.on() 

005. buttons = [Button(2), Button(3), Button(4), 038. sleep(@.5) 
Button(17) ] 039. light.off() 

086. leds = [LED(18), LED(23), LED(24), LED(25)] 049. sleep(9.25) 


042. # get the player's input 


089. 043. for light in sequence: 

018. def lights_on(): 844. guess = None 

011. for led in leds: 045. while guess == None: 

012. led.on() 046. for button in buttons: 

013. 047. if button.is_pressed: 
014. def lights_off(): 048. # convert button push to list 
015. for led in leds: index number 

016. led.off() 849. guess - buttons.index(button) 
017. 0850. 

018. def flash_all(): 051. if leds[guess] == light: 

019. for _ in range(3): 052. light.on() 

028. lights_on() 053. sleep(@.5) 

021. sleep(8.25) 054. light.off() 

022. lights_off() 055. sleep(8.25) 

023. sleep(8.25) 0856. else: 

024. 057. print("You failed at level ", 
025. lights_off() len(sequence)) 

026. 058. for _ in range(18): 

027. while True: 059. light.on() 

028. # Add a new light to the end of the sequence 060. sleep(@.15) 

029. new_light - random.choice(leds) 061. light ott) 

030. sequence.append(new_light) 062. sleep(@.15) 

031. 063. sequence = [] 

032. # Flash all before playback 064. break 

033. flash_all() 


works its way through the sequence list, accepts a 
guess, and checks whether it matches the current 
item in the sequence. There are three loops inside 
each other here. The program sets the guess 
variable to None, a special value in Python. Then 
awhile loop keeps repeating until the guess 
variable changes. Inside that, a loop goes through 
the buttons list, checking each one in turn to see 
whether it’s pressed. If so, the guess variable is 
changed, ending the while loop. The program 
converts the button the player pressed into its 
index number in the list and puts that into the 
guess variable. That way, we can match the button 
to its LED, which will be at the same position in the 
leds list. You can find the position of an item ina 
list using listname. index(item). 


Check the player's guess 

We’re still inside the loop going through 
the sequence here, as the indentation of line 51 
shows. Now we check whether the light the player 
guessed (leds[guess]) matches the current light in 
the sequence. If so, the light is turned on and then 
off again. If the two lights don’t match, the player 
made a mistake. We can tell how long a list is using 
len(listname). We use the length of the sequence 
list to tell the player which level they got to. The 
correct light is then flashed quickly ten times. The 
sequence list is emptied to start a new game, and the 
break instruction breaks out of the for loop that’s 
getting player input. When the player has either 
guessed all the lights, or failed, the game repeats 
from line 28, adding a new light to the sequence. M 


TopTip è 


Underscoring 
repetition 


Theline for _ in 
range(3) repeats 
the indented 
instructions three 
times. The _ 
shows we don't 
need to use the 
loop number. 
Often, you'd 

use a variable 
name instead. 
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Discover the easy way to control GPIO pins on your Raspberry Pi 


All Models 
3V3 5V 
Power 1 2 Power 
GPio2 fen 5V 
SDA PC (3) 4 Power 
GPIO3 ( 5 ) © Ground 
SCL PC X 
GPIO4 910) GPIO14 
UARTO TXD 
Ground Q (10) GPIO15 
UARTO RXD 
GPIO17 010) GP1018 
GPIO27 ©) ® Ground 
GPIO22 ()() GPIO23 
sv3 I (47 GPIO24 
Power 
GPIO10 120) Ground 
SPI MOSI 
GPIOg @)@) GPIO25 
SPI MISO 
GPIOA1 CIE) GPIO8 
SPI SCLK SPI CEO 
Ground (25) GPIO7 
SPI CE1 
ID SD ID SC 
PC ID 27 28 PC ID 
GPIOS © Ground 
GPIO6 919) GPIO12 
You'll Need GP1013 Gi 34) Ground 
Rasbperry Pi GP1019 6) GP1016 
Breadboard 
N GPIO26 910) GP1020 
Button Ground Gel GPIO21 
Jumper cables 
n 


| 


USB Ports 


34 | @ Get Started With Raspb 


> 


ss oo... 
ee se œ zs eessen 
ses e D eee zess ses 
sees D ... oer 
s.e.. _ — — 
sees D see e e 
sees D ses ee 


Get Started With Raspberry Pi 8 


35 


36 8 Get Started With Raspberry Pi 


The LED is wired up to 
GPIO17 via a resistor. When 
GPIO Zero detects a button 

push, it lights up the LED 


One leg of the 
button is connected to the 
ground rail. The other leg 
is connected to GPIO 21 


DOWNLOAD 
THE FULL CODE: 


button.py 


> Language: Python © magpi.cc/2ehTqVq 


ko 


07 Adding a button 
Now we’re going to add a button to our circuit and 
connect it to GPIO 21 with an LED wired up to GPIO17. 
Buttons are wired up in a similar fashion to LEDs, using 
female-to-male jumper leads. 

Like LEDs, buttons have legs. One leg is wired toa GND 
pin (via the same ground rail you’ve been using for LEDs); 
the other leg is connected to a GPIO pin. Some buttons 
have four legs, so you can connect them to the breadboard 
with their legs straddling the central groove (see the 
breadboard diagram). 


001. from gpiozero import LED, Button 
082. from signal import pause 

083. 

084. led = LED(17) 

885. button = Button(21) 

086. 

887. button.when_pressed = Led. on 
0888. button.when_released = led.off 
089. 

018. pause() 


traffic_lights.py 


> Language: Python 


Button responder 
Unlike LEDs, you don’t need to use a resistor with 
a button. The button’s legs are the same length, and it 
typically doesn’t matter which way around you hook it up 
to the breadboard. 
When the button is pushed, it forms a connection 
between the ground rail and the pin, completing a circuit. 
The Raspberry Pi is set up, using GPIO Zero, to detect this 
connection and respond. 
Open Thonny and create a new file. Enter the code from 
button.py, save the file, and run the code. When you push 
the button, the LED will light up. M 


001. from gpiozero import LED 
002. from time import sleep 
083. 

0084. red = LED(25) 

0885. amber = LED(8) 

886. green = LED(7) 

007. 

0088. green.on() 

0889. amber.off() 

818. red.off() 


011. 

012. while True: 
013. sleep(19) 
014. green.off() 
015. amber.on() 
016. sleep(1) 
017. amber.off() 
018. red.on() 
019. sleep(19) 
020. amber.on() 
021. sleep(1) 
022. green.on() 
023. amber.off() 
024. red.off() 


Going further 


You can achieve a lot more with GPIO Zero than C 
controlling LEDs and buttons. 

For a more detailed look at how you can detect 
motion, control robots, read sensor information (such 
as movement sensors or thermometers), we have 
created a fantastic guide book: The MagPi Essentials: 
Simple Electronics with GPIO Zero. Learn more at 
magpi.cc/gpio-zero. 


= ge D 
ELECTRONICS 


crioZERO 


Raspberry Pi 
Fetz l 
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This humble plastic block full of holes can be used to create just about anything 
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A 
Ce j 


WITH 


<a 


oughta Raspberry Pi to learn how to code 
gizmos, then you have made 


arted with this guide... 


If you have b 
and hack new electronic 
a great choice. Get st 


f you have just got a brand new 

shiny Raspberry Pi, you may have 

plugged it in and got it working. 
You may have played a few of the games 
or tried out the applications, or maybe 
you’ve loaded one of the programming 
tools and then looked at it wondering 
what to do next. If you haven’t done 
any programming before, we have 
wisdom for you here. In the next few 
pages you’ ll find answers and probably 
some questions, but then some more 
answers. Before you know it you will be 
a coding, hacking ninja. 


it you have never done 
any programming before, this 
may appear a bit daunting, 
but it's quite easy really 


If you’re new to programming, this 
may appear a bit daunting, but it’s 
quite easy really - you’ve just got to 
get stuck in and start with some simple 
things that will get you results. One 
of the programming languages that is 
supplied with Raspberry Pi is Python. 
It’s very easy to get started with Python 
and it can be used to program many 
of the add-ons that are available for 
Raspberry Pi - so this is going to be 
very useful to learn. We can get you 
up and coding in 30 seconds flat; just 
read on... 


` 


To get started with coding is really easy. Coding 
is just giving a Raspberry Pi an instruction to do 
something. The only thing you need to know is 
what language to talk to it in. In this case we are 
going to talk in Python 3. We will need to write 
our instructions somewhere so, to start, open a 
Terminal window - click the icon in the top left 
of the screen which is a grey box with a blue bar 
across the top. This opens a black window with a 
prompt: pi@raspberrypi:~ $ in green. If you type 
python3 and hit ENTER, Python starts and you 
will see the triple chevron prompt: >>>. Now type 
print("Hello") and hit ENTER. Bosh! Your first 
program. You have instructed your Raspberry 

Pi to print the word ‘Hello’ and, all being well, 

it has obeyed. 

Entering programs like this is not going to be 
very useful most of the time, so now let's look at 
an app we can write and save a program with. 
Go to the desktop menu (click the Raspberry 
Pi logo in the top left of the screen) and in the 
Programming section, select Thonny (which 
should then open by default in its Simple mode). 
Try typing in the following program in the 
Thonny editor and save it, then run it by clicking 
the Run button. The output will be displayed in 
the Shell frame below the program editor. 


Mark 


Vanstone 


mwc1.py 


. import random 


False 
e P random. 
ec D 
. while correct == False: 
("Guess my number between 1 and 10: ") 
EI 
if (n) == r: 
correct = True 
else: 
if (n) > r: 
("Sorry, my number is lower. Try again.") 


. correct = 
(1,10) 


else: 
("Sorry, my number is higher. Try again") 
("well done. The correct answer was " 
You got it in" + (c) + " tries.") 


+ (r) +". 


Get Started With Raspberry Pi & | 41 


Coding involves using several el 


a look at a range of them and how they work 


Want to learn more 
about coding? Check 
out our guides to 
Python coding and 
object-orientated 
programming in 

The MagPi #53 and 
#54 respectively. 


keyboard and output text and numbers by 

using the print() function. We have also used 
a condition structure in the form of if and else. 
Python is very particular about how you indent the 
code with spaces (four per indent level); this shows 
that the indented code is inside another structure. 
In the last program, everything indented after the 
while statement will be part of that loop. Let’s take 
a look at a few more coding techniques. 


i n the last program, we get input from the 


ements. let's take 


Import modules 


Make new 


answer string 
Define data 


While not finished, 
input new guess 


Player wins Player loses 


A After initialising the data the program 
needs, we loop round, updating the 
answer variable until the player guesses 
all the letters or they run out of tries 


theWord. When we call a function that is inside 

a module, we use a full stop between the module 
name and the function name. Next, we want to get 
the player to start guessing what the word is. If we 
look at the bottom of the code, we can see that we 
call a function called startGuessing(). This is our 
own function that we need to define. 


01 Using lists 
We are going to write a Hangman-style 


game, where we start with a secret word and the 
player has to guess it, letter by letter. If correct, we 
show them where that letter appears in the word. 
They are allowed ten wrong attempts before the 
game ends. See the mwc2.py code to follow along. 
First, we make a list of words to choose from. A 
list is defined in Python using square brackets, 
like: list = ["a","b","c"]. We’ll call our list 
WORDLIST. In this case we’re writing the list name 
in upper case to show that it is a constant, i.e. It is 
not going to change throughout the program. 


Pick a word 

We can pick a word from our list using the 
random module. We import the module at the top 
of our code, then we can use the random. choice() 
function to get a word and store it in a variable: 
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03) Defining functions 

Each time we call a function, the code inside 
it runs. Sometimes functions have outputs, like our 
function updateAnswer() that returns the variable 
result. One of the rules of Python is that you must 
define a function before you call it, so we will need 
to define our startGuessing() function near the 
top of the code. To do so, we write def and then the 
name of the function, followed by brackets and a 
colon. If we want to pass variables as inputs into a 
function, we can add them inside the brackets. 


04 Getting loopy 


Now for the code in our startGuessing() 
function. We set the number of tries and dashes, 
one for each letter of the secret word, then we go 
into a loop. The code says: “While the player still 
has some tries left and the answer we have is not 
the secret word, run the following code.” In our 
loop, we print the answer we have so far and how 


random 


003. WORDLIST = [ 


FEATURE HEN 


imwe2.py 


3 3 3 3 

3 3 ] 
084. theWord = random.choice(WORDLIST) 
085. 
086. def Q: 
007. triesLeft 10 
088. answer len(theWord) 
089. 
010. triesLeft 1 answer theWord: 
011. print("\n answer) 
012. print(str(triesLeft) ) 
013. guess = input( ) 
014. len(guess) 1: 
015. print( ) 
016. guess theWord: 
017. print( ) 
018. answer updateAnswer(theWord, answer, guess) 
019. : 
020. print( ) 
021. triesLeft 1 
022. 
023. triesLeft e: 
024. print( theWord) 
025. : 
026. print( theWord) 
027. 
028. def d y ): 
029. result 
030. i range(len(word)): 
031. word[i] guess: 
032. result = result + guess 
033. : 
034. result = result + ans[i] 
035. result 
036. 
037. print( ) 


038. startGuessing() 


many tries the player has left. Then we use an if, 
elif, else condition structure to respond to the 
player, depending on what they typed. 


05| Changing the answer 


If the player guesses a letter correctly, we 
call another function: updateAnswer(). This 
uses a for loop to add the correct letters into 
our answer variable, then return that string (a 
variable containing letters/characters rather than 
a numeric value). This then becomes the answer 
variable that we print at the start of each loop in the 
startGuessing() function. When the player has 


guessed all the right letters in our word or they have 
got it wrong ten times, the program will drop out of 
the loop to reach the final part of the function. 


Win or lose 

We have an if and else structure to print 
congratulations, or let the player know they’ve run 
out of tries. A few of the functions are used with 
variables: len() finds the length of a string, and 
str() converts a number variable into a string so 
it can be added to the start or the end of another 
string. After the function is complete, it returns to 
where it was called, which is the end of the program. 
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into our code and used functions from it. If we 

want to control electronics from code, there 
is a very useful module available called gpiozero. 
GPIO stands for ‘general-purpose input/output’ 
and the line of double pins on one side of your 
Raspberry Pi are called GPIO pins. For details about 
the labels of all the pins, see pinout.xyz. If we 
connect electrical components to these GPIO pins, 
we can use the gpiozero module to make things 
happen. When we import a module, there are often 
many different functions inside. We can also make 
new coding ‘objects’ with them. Objects are like 
variables but have their own set of functions and 
properties inside them that we can call or change, 
and we do that using the same dot notation (full 
stop) that we did with the random module. For 
Now we ve got the hang of the coding, let's put more details on using coding objects (called object- 


oriented programming or OOP), see issue 54 of 
it to work with some electronic Components The MagPi: magpi.cc/54. 


j n the previous example, we imported a module 


The breadboard 


Breadboards come in various sizes, but 
they all work in the same way. If there are tracks 
marked red and black/blue (and/or + and -)on the 
A breadboard } = long edges of the board, these are for power and are 
i connected along the length - although sometimes 
divided into sections. The matrix of holes which 
make up the main part of the board are connected 
in lines the other way (vertically in the diagram). 
There is usually a break in the centre of the board 
A resistor 1 so that the two sides are not connected. 


2 x male-to-female 
jumper wires 


02 Light-emitting diode (LED) 
An LED is a bit like a bulb in that if you apply 
electricity to it in the right way, it lights up. An LED 
is also a diode, which means that the electricity 
needs to flow in the correct direction or it will not 
light. When connecting an LED to Raspberry Pi, we 
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» 


need to add a resistor to the circuit, 
as most LEDs will burn out if we 
connect them directly to the main 
power output. In the example, we are 
using a1kQ resistor, but it’s fine to 
use another similar value. To light 

an LED using gpiozero, assemble 
the components as in the diagram, 
then write a Python program: start 
with from gpiozero import LED, 
then create an LED object with led = 
LED(17), and finally type led.on() 
to light the LED. 


| 
, 


Aresistor 

Resistors do what their name 
suggests: they resist the flow of 
electricity (current). Some components 
need to have a certain amount of current 
in order to operate correctly. Resistors | 
enable us to set the current or voltage to a 
a suitable level for the other components S 
we are using. There are many different i 
types of resistors, with different 
resistance values. The resistance value | 
can be read from the pattern of coloured 
stripes on the resistor. You can also 
get variable resistors, which are known 
as potentiometers. 


Jumper wires 

We need to connect 
our components to 
Raspberry Pi’s GPIO pins. 
For this we use jumper 
wires. The ones we will 
be using have a female 
connector at one end, 
to go on the GPIO pins, 
and a male connector 
to go in the holes of the 
breadboard. You can also 
get jumper wires with 
both male connectors or 
both female connectors, 
for different situations. 
They can be bought in 
strips all joined together, 
sometimes known as 


‘jumper jerky’. 


it 


FEATURE 


You can control the 
state of the LED using 
the gpiozero module 
in Python 


Potentiometer 
A potentiometer is a variable resistor. It 
usually has a turning spindle that changes the 
resistance from one value to another, quite often 
rom no resistance to full resistance (no electricity 
flowing). A potentiometer can provide us with 
a variable output voltage which we can measure 
with the GPIO, but there is a slight problem. The 
potentiometer provides an ‘analogue’ 
output (varies continuously 
between values) and the GPIO 
inputs are only digital, i.e. 
on or off. So we need another 
component: an analogue-to- 
digital converter (ADC). 


Electronits 


guide 


Analogue-to- 

digital converter 
ADC components come in various forms, but the 
one we have in this example is called an MCP3008. 
It’s an integrated circuit (IC), meaning that it’s a 
box with some circuitry inside it. We don’t need 
to know what is inside it - we just need to know 
what to connect to each of the legs of the IC. We 
will need to wire up several of the legs to GPIO pins 
and provide the IC with power; when we’ve done 
that, we can connect the potentiometer to the IC 
and then read values in 
showing the position 
of the potentiometer 
spindle using the 
gpiozero module. 
We’ll cover the code y 
in the next section. 


ee 
= 
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Breadboard 


6 x male-to-female 
jumper wires & 
10 x male-to-male 


jumper wires 


2 x potentiometers 


MCP3008 
integrated circuit 


Now to put what we have tovered to the test: we will make a 
retro game and control it with our own homemade controllers 


n the previous page we talked about 
©) potentiometers and analogue-to- 

digital converters, and this is where 
we get to use them. It’sa bit more complicated 
than lighting up an LED, but only a little. First, 
we are going to write a program which has two 
rectangular bats at each side of the screen that 
can be moved up and down by two players. A ball 
bounces backwards and forwards between the 
bats until one player misses the ball and the other 
player scores a point. That’s right, you guessed 
it, the game is Pong and we are going to create a 
controller for each player from a potentiometer 
and wire it into our Raspberry Pi. 


Super-fast game coding 

If you have been following other coding 
articles in recent issues of The MagPi, you will 
know that when writing a quick game on Raspberry 
Pi, Pygame Zero is your friend. We can make the 
basics of the game code very quickly by importing 
the pgzrun module, which holds all the Pygame 
Zero code. We need to call pgzrun. go() at the end 
of our code, and that’s our game window sorted. As 
with all Pygame Zero programs, we have a draw() 
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function to write the graphics to the window, and 
an update() function to update the game items 
between draw cycles. 


02| Running the code 


The listing mwc3.py provides all the code 
you need for the game to work. There is some code 
in the updatePaddles() function for the keyboard 
to control the paddles or bats, just in case you want 
to test it before making the proper controllers. We 
import several modules with this code. We have 
covered pgzrun, but we also need random so that 
the ball will move in a random direction each time 
it starts. In addition, we need gpiozero to deal 
with the input from the controllers, and we need 
the math module for calculating the direction of 
the ball. 


03| Wiring it all up 

One thing to bear in mind when connecting 
any electronics to a computer is that if the 

wires are connected in the wrong way, you may 
cause damage to the computer or the electronic 


008-vP@> 
= D 1808 1uG 


It may seem like a lot of 
wires, but work through 
the diagram methodically 
to make sure they are 
plugged in correctly 


— er 


components, so it’s always a good idea to power off case. You will see from the diagram that all the legs 

your Raspberry Pi before connecting anything to on the top side of the IC are connected to either 

the GPIO pins. Follow the wiring diagram (overleaf) GPIO pins or to power lines. There are two red 

carefully, making sure that the jumper wires are connections going to the positive power track, then 

connected to the right GPIO pins and to the correct a black lead to the negative or ground track. Then 

places on the breadboard. Once you have put there are four coloured wires that go to: purple - y 
everything in place, it’s a good idea to have another GPIO11; green - GPIO 09; orange - GPIO10; and X 
check just to make sure. blue - GPIO 08. Then there is one last connector to . 


the ground track. 


The MCP3008 IC 

The MCP3008 converts the voltage from our The inputs 
potentiometers into a number with the help of the All the MCP3008 pins on the bottom side 
gpiozero module. It has eight channels for input, of the IC are input channels. We will use the first 
but we are going to just use two of them in this two pins, which are channel 0 and channel1. We 
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connect the middle pins of our potentiometers to 
those channel pins, which will read the positions 
and convert that to a value in our program. If you 
want to know exactly what all the pins are for on 
this IC, you can do a web search for ‘MCP3008 


LINAH 


The MCP3008 A : ` Kate 

straddles pinout’ and that will give you descriptions of each. 
the centre ICs are very useful in electronics as they mean that 
break of the we can reduce how complex our circuits are and we 
breadboard so don’t need to know exactly how they work inside. 
that the pins on They are a little bit like modules in Python. 

either side are 


not connected 


ol Finishing the job 

When you have checked that all the 
connections are correct, you can switch your 
Raspberry Pi back on and reload your program. You 
may want to initialise the SPI interface on your 
Raspberry Pi by going to the main desktop menu 

> Preferences > Raspberry Pi Configuration, and 

go to the Interfaces tab. It will work without this, 
but may cause a few warnings in the Thonny shell 
window. So, all being well, when you run your 
program you will have a game of Pong which can be 
controlled by two players with the potentiometers. 
If it doesn’t work first time, check your code and 
then your wiring, and try again. 


The left-hand 
potentiometer's 
middle pin 
connects to pin 
o, and the right 
one's to pin 1 of 
the MCP3008 


A When everything is 
plugged in and working, 
you can play Pong! 
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084. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 


023. 


024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 


035. 
036. 
037. 
038. 
0839. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 


pgzrun 
random 

gpiozero 
math 


MCP3088 


pot1 = MCP3088(®) 
pot2 = MCP3088(1) 


# Set up the colours 


BLACK = (0 D D? 
WHITE = (255,255,255) 
p1Score p2Score = 0 
BALLSPEED 5 
p1Y = 300 
p2Y = 300 
def (): 
screen. fill(BLACK) 
screen.draw.line((499,0), (400,600), ) 
drawPaddles() 
drawBall() 
screen.draw.text(str(piScore) , (105, 
40), WHITE, 60) 
screen.draw.text(str(p2Score) , (705, 
40), WHITE, 60) 
def (): 
updatePaddles() 
updateBall() 
def (): 
ballX, ballY, ballDirX, ballDirY 
bal1x 400 
bally 300 
a = random.randint(10, 350) 
(a > 80 a < 100) (a > 260 a 
280): 
a = random.randint(10, 350) 
ballDirX = math.cos(math.radians(a)) 
ballDirY = math.sin(math.radians(a)) 
def (): 
p1Y, p2Y 
plrect = Rect((100, p1Y-30), (10, 60)) 
p2rect = Rect((700, p2Y-30), (10, 60)) 
screen.draw.filled_rect(pirect, ) 
screen.draw.filled_rect(p2rect, ) 
def Q: 


p1Y, p2Y 


p1Y = (poti.value * 540) +30 


052. 
053. 
054. 
055. 
056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 


067. 
068. 
069. 
070. 
071. 
072. 


073. 
074. 
075. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 
091. 
092. 
093. 


094. 
095. 
096. 
097. 


FEATURE E 


p2Y = ( 
pot2.value * 540) +30 


keyboard.up: 
p2Y > 30: 
p2Y 2 
keyboard. down: 
p2Y < 570: 
p2Y 2 
keyboard.w: 
p1Y > 30: 
p1Y 2 
keyboard.s: 
p1Y < 570: 


def (): 
ballX, ballY, ballDirX, ballDirY, 
piScore, p2Score 


bal1x ballDirX*BALLSPEED 

bally ballDirY*BALLSPEED 

ballRect = Rect((ballX-4,ballY-4),(8,8)) 
plrect = Rect((100, p1Y-30), (10, 6@)) 
p2rect = Rect((700, p2Y-30), (10, 69)) 


checkCollide(ballRect, pirect) 
checkCollide(ballRect, p2rect): 

ballDirx 1 

ballY < 4 ballY > 596: 
ballDirY 1 

ballX < 0: 
p2Score 1 
init() 

ballX > 800: 
p1Score 1 
init() 


def (r1,r2): 


) 
def (): 
screen.draw.filled_circle((ballX, ballY), 8, 
) 
init() 


pgzrun.go() 
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ZS TUTORIAL 


RASPBERRY PI 
ACCESSORIES 


Our guide to the greatest add-ons, HATs, 
and expansions for your Raspberry Pi 


aspberry Pi is fantastic on its own. 
H With wireless LAN, Bluetooth, 

USB ports, the multitalented GPIO 
pins, and a full operating system, it really 
is a fully functional computer. 

What if you could make it better? Do 
more? Make certain functions easier? This 
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is where add-ons and accessories come in 
- there are hundreds of extras you can get 
for your Raspberry Pi that will improve its 
already impressive specs. 

What add-ons should you get, though? 
We’re here to show you the best the 
Raspberry Pi world has to offer. 


TUTORIAL 


We’ll start with an important 
one. HAT stands for ‘Hardware Attached 
on Top’ (it’s a backronym), and is a standard for 
add-ons. That means there are specific definitions of how 
a HAT can connect and work. All you need to be concerned 
with is that a HAT fits perfectly on top of a Raspberry Pi, 
connecting to the GPIO pins. You will usually need to install 
extra software to get them working. 


While the HAT standard has recently 

been extended to different sizes, many 

MOO OTT a companies have created their own term 
WWW E for add-ons that act like a HAT but 

IP: 19.0.0.19 (3 3 don’t quite meet the technical criteria. 


Men: 98/430 17. 97% ES EE WE Pimoroni coined pHAT, and Adafruit 
d um 


en uses Bonnet, and other firms 
tend to use similar 
variations on the 
headwear theme 


12C Pi OLED 


paean 


ARR 


En | 


A HAT is an add-on, but an add-on isn’t necessarily a HAT. 
Add-ons can be connected via USB, only specific GPIO pins, 
the camera port, etc. It’s a catch-all term for something 
that you can add onto your Raspberry Pi in some way. 
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PROGRAMMING AND 
MAKER ACCESSORIES 


Improve your projects with these add-ons 


magpi.cc/xcsSpm 
price: £37 / $50 


his dual motor control 
oard by the folks at 
iBorg is a powerful 

nd robust way to use a 
aspberry Pi to control 
robot. As well as being 
ble to make the motors go 
forward and back, it can control 
the speed for more precise 
manoeuvring, and can take a 
wide array of power inputs. 


TH 


Wel 


oo o D 


magpi.cc/sense-hat 


price: £30 / $37 


Developed for the Astro Pi mission, the Sense HAT is primarily a set of 
environmental sensors. It can detect pressure, humidity, temperature, and 
orientation/movement. It also has an 8x8 LED matrix and a little joystick for 
very basic display and control. There are a couple of Sense HATs running on 
Raspberry Pi boards up on the ISS at the moment. 
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Use it with: Weather stations, space stations 
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Hologram Nova 


hologram.io/nova 
price: From £53 / $64 


Despite the world’s best efforts, WiFi is not 
available absolutely everywhere yet. You can’t even plug an 
Ethernet cable into a tree! The Nova solves this problem by letting you connect 
to cellular networks around the world on your Raspberry Pi via this USB device. 


Use it with: Portable projects, outdoor cameras 
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Edge TPU Accelerator 


magpi.cc/TFLQpM N 

price: £61 / $75 G ae 

Google was responsible for the AIY I : 

Voice Kit - a special HAT and extras / Le 
f d 


Ee iesen a yi 


that lets you turn a Raspberry 
Pi into an AI voice assistant. 
The Edge TPU accelerator 
aims to help Raspberry 
Pi out with Al tasks, 

and make your voice 
assistants better. 


Cluster HAT 


magpi.cc/Qrshbi 
price: £31 / $37 


Use it with: Voice control, Al 
projects 


Putting Raspberry Pi boards into 
a cluster isn’t that tricky, but 
the Cluster HAT makes it very 
easy. Using one Raspberry Pi, 
you can distribute computing to 
up to four Raspberry Pi Zeros. 
Cluster computing is a great 
way to perform different kinds 
of calculations. 


eect nn a a ee EE E 


eee me mn RR RH = KK = | eee 
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128x64 MONO DFs HATS raume 2 


Use it with: Mathematics, 
big algorithms 
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Ultimate GPS HAT 


magpi.cc/vmPqLL 
price: £42 / $45 


H 


GFX HAT 


This GPS add-on allows you to 
track the precise location of your 
Raspberry Pi - well, as precise 

as GPS can be. Yov’ll have to 
combine the position data with 
map data to make much use out 
of it, but once you have it all 
working it’s pretty fantastic. 


magpi.cc/ZWvcLG £22 / $22 


A very functional screen that draws a lot less power than most displays, it also 
includes six capacitive touch buttons for control. It’s the successor to an excellent 
add-on known as Display-O-Tron, and makes interactive projects look great. 


Use it with: Thermostat, practical projects Use it with: Sat-navs, route tracking 
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Using a Raspberry Pi for 
enterprise? You may want 
to check these out... 


magpi.cc/FnezCP 
£22 / $27 


Another remote-control power 
solution, this one is designed for ` ma ne ne Satj p 
Raspberry Pi to control power ? o Rospberry Pi PoE-HAT , 
elsewhere. There are various e ss (e) Raspberry Pi 201% 
Energenie Pi-mote products, 
the cheapest starting at £10, 


but the starter kit version also magpi.cc/aqpwZc £18 / $22 

includes compatible sockets. 

You can even get a Pi-mote Raspberry Pi 3B+ and 4 models include proper Power-over-Ethernet support, 
that allows the plugs to talk to although you need one of these HATs to get it working. Of course, the network 
Raspberry Pi as well. needs to be set up to support (i.e. power) the PoE and Raspberry Picombo. It 


Use it with: Timed-lighting, also currently only works on Raspberry Pi 3B+ and 4. 


some loT Use it with: Server racks, headless solutions 


magpi.cc/merPpf 
£20 / $25 


Serious Raspberry Pi users often need power management and a real- 
time clock (RTC) for various reasons. The Witty Pi 2 offers these things, 
along with some extra on/off functions that can programmed. As 
Raspberry Pi normally requires the internet to check the time, an RTC is 
essential for scheduling tasks on a Raspberry Pi that’s not online. 


Use it with: Industrial settings, automated solutions 
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dinrplate.com 
From £10 / $13 


Want to use a Raspberry Pi in a server environment, but don’t 
need a UPS or RTC or any of the advanced stuff like that? Just 
have some DIN rails handy anyway? Then the DINrPlate is an 
excellent add-on that lets you mount a Raspberry Pi to a DIN 
rail without any fancy extras. And the price reflects that. 


Use it with: DIN rails, DIY servers 


Ries 


7 e magpi.cc/rfBfvo 
price: From £206 / $266 


magpi.cc/ZvesrZ £18 / $22 


Are you asysadmininabig 
company that would like to use 
Raspberry Pi boards? The Strato 
Pi turns a Raspberry Pi into a 
server good enough to pass 

the rigorous tests of enterprise 
IT. It has an impressive list 

of features: RTC, UPS, two- 
module DIN-rail case, RS-485, 
and more. 


Use it with: Enterprise, servers 


© On/off switch solutions for Raspberry Pi have 
been around as long as Raspberry Pi itself, 
Q but none of them has been that great. 
Along comes the Hackable Pi Switch 
Cap from Nanomesher and finally we 
have one that does everything you 
need. By default, it allows you to turn 
your Raspberry Pi on and off with a 
S) button, and you can reprogram it to 
do more with an included remote. 


(a) (w) Use it with: Desktop Pi, HTPC Pi 
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Improve your listening, watching, and more 


magpi.cc/aimAyy 


price: From £20 / $24 


There are many digital-to-analogue converters (DACs) 
that turn Raspberry Pi into a powerful stereo, but we’re 
partial to the HiFiBerry DAC+ range. There are cheaper 


versions, smaller versions, more powerful versions, and 
all of them improve your Raspberry Pi’s sound. 


Use it with: Stereo system, PA 


Deere gsoe eee eenennnnanea 
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Se HiFiBerry magpi.cc/WgSmAA 


He x : From £37 / $37 
[Gj S 


HiflBerry OAC+, HW 1.0 
www Mib cen 


The HyperPixel 4.0 is a massive, wonderful screen 
for Raspberry Pi that you can get with or without a 
capacitive touch function. It’s dead simple to set 
up and, due to the high pixel density, it’s great for 
watching media or looking at pictures. 


Use it with: Portable media projects, wall screens 


magpi.cc/2ve6iUo 
£6 / $7 


If you’re playing retro games with your Raspberry Pi, you 

A might want a retro controller to help it feel more authentic. We 
recommend one of the many available in this classic style, with enough 

buttons to play any game prior to 1996 and some afterwards as well. 


Use it with: Retro games console, RC car projects 
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magpi.cc/ryviXi price: £20 / $25 flirc.tv 


From £20 / $25 
The official Raspberry Pi TV HAT is pretty amazing - its most basic 
function is allowing you to tune into TV signals using your Raspberry Pi. For applications such as Kodi, 
That’s pretty standard, but the amazing part is its ability to stream said TV there are plenty of ways to 
not only around your network, but also over the internet if you’re abroad and control your Raspberry Pi- 
missing the latest episode of GBBO. based home theatre PC via your 


smartphone or tablet. FLIRC 
makes the whole thing a bit 
simpler, though: take your 
favourite remote, let FLIRC 
know which button is which, 
and then just plug it into your 
HTPC. Simple. 


Use it with: DIY DVR, TV anywhere 


Use it with: Kodi setups, remote- 
controlled loT 


lightberry.eu 


From £94 / $114 


Ever wanted your films to expand out of your TV? With Lightberry, you can 
install DIY Ambilight-like effects to your TV so that special effects become 
just that little bit more special. There are various kits to choose from as well. 


Use it with: HTPCs, magic mirrors 


magpi.cc/BupAFF 
£16 / $16 


The Picade is Pimoroni’s 
excellent tabletop arcade kit, 
and its newest iteration is 
controlled by the powerful 
Picade X HAT. It’s so good, 
they made it so you could buy 
it separately to use in your own 
DIY Raspberry Pi arcade setup. 


Use it with: Arcade builds, 
remote controls 
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with the TV HAT 


Set up your new add-on to stream live TV from and to a Raspberry Pi 


Phil 
King 


When not subbing 
The MagPi and 
editing Raspberry 


Pi books, Phil he latest official Raspberry Pi add-on is 

a a must for telly addicts. The Raspberry Pi 

ee y TV HAT enables any Raspberry Pi (with Assemble and mount 

Crown) and other 40-pin GPIO) to decode live digital TV signals and Insert the thin end of the supplied silver RF 

(old Dynasty stream them to remote devices - such as another cable adapter into the gold connector on the side of 

N Raspberry Pi, computer, or even asmartphone. the HAT. Take the 40-pin header and insert its pins 
The HAT’s built-in Sony CXD2880 tuner supports into the holes in the underside of the HAT - not 
DVB-T2 and DVB-T standards (Freeview in the UK), into the black female header on the top! Mount the 

R so you can watch all your favourite channels. Here HAT on your Raspberry Pi, with the RF adapter at 

You'll Need we show you how to set it up, and even use it to the microSD card slot end. To make it secure, you 

turn a Raspberry Pi into an all-in-one TV/PVR. can screw it in using the supplied stand-offs. 


Raspberry Pi TV HAT 


Wireless network 


Computer 


2 


- A 


Recording : : = 
i == 
Add a hard drive k = N 
or USB stick to Í ae = Lf 
Raspberry Pi to turn : = au] 
it into a capacious Connect your TV aerial = With the supplied header 
homemade PVR cable to the HAT via s = . inserted on its underside, the 
with LibreELEC. the supplied adapter ee i = RT HAT is mounted on Raspberry Pi 


eer 


58 8 Get Started With Raspberry Pi 


Install Tvheadend 

Connect a coaxial RF cable from a TV aerial 
socket to the RF adapter on the HAT. You’ll need 
decent digital terrestrial TV (Freeview in the UK) 
reception for the tuner to work. With Raspbian 
Stretch installed on its microSD card, turn on your 
Raspberry Pi - a green LED will light on the HAT. 

We need to install a back-end TV service to 

stream video: wel use Tvheadend. To install it, 
open a Terminal window and enter: 


sudo apt-get update 
sudo apt-get install tvheadend 


Configure Tvheadend 

It takes a few minutes for Tvheadend to 
install, so you may want to go and make a cup 
of tea. Once installed, a package configuration 
screen will appear and you’ll be prompted to 
enter a Trheadend administrator user name. 
For simplicity’s sake, enter kodi for this, then 
also enter kodi for the password - you can always 
change it later if you prefer. You’re now ready 
to log in from another device. 


Log in remotely 

Now that Tvheadend is running, you can 
access it from another computer (possibly a second 
Raspberry Pi). In a web browser, enter this address: 
http://raspberrypi.local:9981/extjs.html. If that 
doesn’t resolve, use your Raspberry Pi’s IP address 
instead, followed by :9981/extjs.html. Log in 
using kodi for both the username and password. A 
configuration wizard will appear, enabling you to 
choose the TV network type and transmitter. 


Configure TV network 

In the configuration wizard’s ‘Network 
settings’, it should show ‘Tuner: Sony CDX2880 #0 
DVB-T #0’. For the Network Type, choose ‘DVB-T 
Network’. For predefined muxes, select your local 
transmitter: for example, ours was uk-Rowridge. 
Upon clicking Save & Next, it’ll start scanning for 
muxes and services (channels). After it reaches 
100%, tick all three boxes (Map all services, 
Create provider tags, Create network tags) and an 
electronic programme guide (EPG) will appear. 


TUTORIAL HEN 
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‘Stay up to date on the day's top stories, wit... 
(1089) Flim noir starring Frank Lovejoy and... 


Watching TV 

You can now watch live TV streamed from 
the TV HAT in your browser. In the EPG, click the 
TV icon to the left of any programme to show it in 
a window, which you can expand to full-screen. 
There are also options to schedule and record 
shows - use the Help option for more details. 

As well as using a web browser, you can view 
the TV stream from a variety of clients, including 
Kodi, omxplayer, VLC, and smartphone apps - 
see magpi.cc/ZpJtwd. 7 


Using LibreELEC 


The live TV stream from the TV HAT can be accessed 
in the Kodi media player, most easily by using 

the LibreELEC OS on a Raspberry Pi. Install the 
Tvheadend client by selecting Add-ons > Install from 
repository > PVR clients > Tvheadend HTSP Client. 

In addition, using LibreELEC, it's possible to set up 
both the Tvheadend client and server on the same 
Raspberry Pi - a Pi 2, 3, 3A+, 3B+, or 4 is recommended 
- for an all-in-one TV/PVR device. To do so, select 
Add-ons > Install from repository > Services > 
Tvheadend Server 4.2, and install it. Access it from 
another computer using the IP address followed by 
19981 and set it up as in Step 5. You can then access 
it from within LibreELEC (with the Tvheadend client 
installed) by selecting the main ‘TV’ option. 

To make TV recordings, you'll need to create a 
recordings folder on a connected USB stick or hard 
drive - navigate to it in File Manager, right-click, 
and select ‘Make new folder’). Then, in the web 
interface on a remote computer, go to Configuration 
> Recordings and set the recording system path to 
var/media/lyour_drive_namel/recordings. 
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the EPG and 

watch live TV ina 
web browser ona 
remote computer 


TopTip è 


Live viewing 


The live TV stream 
can be accessed 
in many ways, 
including Android 
and iOS apps. 


Get Started With Raspberry Pi & | 59 


Ms TUTORIAL 


Marc Scott 


Marc is a former 
teacher of 
Computer Science, 
and is currently a 
learning manager 
at the Raspberry 

Pi Foundation. 


magpi.cc/ZHdSsd 


l You’ll Need 


> Raspberry Pi (not a 
Zero / Zero W) 


> Sense HAT 


> Speakers or 
headphones 


Make a Sense H 
MP3 player 


Turn a Raspberry Pi and Sense HAT 
accessory into an MP3 player 


MP3 player using a Raspberry Piand a Sense 

HAT. You’ll be able to shift between tracks in 
your playlist, change the volume, and show a cool 
disco display on the LED matrix. 


| n this project, you will be making your very own 


Get set up 

Open up Scratch 2 on your Raspberry Pi 
(choose Menu > Programming > Scratch 2). Now 
choose a sprite for your MP3 player. Right-click 
on the cat sprite and choose Delete. Click on the 
‘Choose sprite from library’ icon; now choose 
Things in the sidebar and highlight Speaker. Click 
OK to add it to the Stage. It will add some blocks to 
the scripts area - right-click to remove them. 


Add GPIO support 

A special GPIO extension in Scratch 2 on 
Raspberry Pi is needed to control and read input 
and output components connected to the GPIO 
pins. With Scratch 2 open, click on More Blocks 
in the Scripts menu. Next, click on the ‘Add an 
Extension’ button. You can then double-click on 
the ‘Pi SenseHAT’ extension to add it. You should 
now see the Pi SenseHAT blocks in the More 
Blocks section. 


Create a disco effect 

Click Events and drag awhen flag clicked 
block to the scripts area. Choose the Control tab 
and add a forever block below when flag clicked. 
Within the More Blocks menu, find the set pixel 
block and drag it inside the forever block. 
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A Step 3 Creating a random sparkle effect 


magpi.cc/Nqwqmz 


The Sense HAT has 
64 LED lights (in 

an 8x8 matrix) that 
can be set to any 
RGB colour. We're 
using them to scroll 
text and create a 
disco effect 


The LED matrix is used to 
scroll track information and 


Use the joystick to switch 


produce a disco light effect 
tracks and adjust the volume 
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C17. „RIG Di 
cit KC Pr! Raspberry Pi Ka speakers, don't 
Sense HAT : forget to change 
Version 1.0 the audio out on 
(c) Raspberry Pi 2015 A ETP 7 your Raspberry 
Pi from HDMI to 
Analog. Right- 


click on the 
Plug headphones or speakers into the volume icon on 
audio socket to hear the music play the desktop. 
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> Step 4 Find 
some music 


YV Step 5 Import 
the MP3 files 


I 
Converting mp3 file. 


Free Music Archive 


Welcome to the Free Music Archive 
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With the pick random block (under Operators), 
you can set random pixel positions and random 
colours within the loop to make your Sense HAT 
sparkle, by choosing LEDs on the Sense HAT to 
light up (numbers between 0 and 7 on the 8x8 
grid), and the amount of red, green, and blue to 
colour the pixels (numbers between 0 and 255). 

Have a go at running your program by clicking 
on the green flag. You should see the LEDs on the 
Sense HAT begin to randomly sparkle. 


Get some tunes 

Now you have a disco effect, it’s time to 
make your MP3 player play some tunes! First, 
save the project. Back in Scratch, click File > Save 
Project > Create Folder. Name the folder Scratch 
MP3 and double-click it to navigate inside. Name 
the file Scratch MP3 Player.sb2 and click Save. 


m It's time to make your MP3 
player play some tunes Ø 


Gather a few MP3 files together to begin with 
- you’ll want at least three. (We’ve downloaded 
three tracks from freemusicarchive.org). Save 
them in the same Scratch MP3 directory as your 
Scratch code. 


Add the sounds 
Click on the Sounds tab for your sprite. Get 
rid of all the stock sounds, such as ‘scratchy beat’ 
and ‘drum jam’ (right-click and select Delete). 
Now use the ‘Upload sound from file’ button to 
upload all your MP3 files. Choose the MP3 files in 
your Scratch MP3 folder and click Open. 


Face the music 

Now it’s time to play your tracks. Your code 
should currently look like that in Step 03. You can 
play a sound using the play sound block. Add this 
block above the forever loop. 

Click on the green flag to play your track as the 

disco lights start. Make sure you have speakers or 
headphones plugged into your Raspberry Pi. 
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07 Analogue out enter ‘track’ in the left field, and drag a track . 
At this point you will need to change the variable into the right field (as shown in the Top TI p a 
sound output to analogue by right-clicking on the image). You can choose whichever colours you like. 


speaker icon in the header bar of the desktop and Shuffle 
then clicking the Analog option. 


Next, you’re going to display the number of the 


A nice feature 


track that’s currently playing. Click on Data and Volume control tO FAN oman 
: ene A e MP3 player is the 
Make a Variable; call it ‘track’ (leave it set for all You can now add some extra controls to your option to shuffle 
sprites and click OK). MP3 player. First of all, set up your script so that the tracks so 
the Sense HAT joystick can control the volume. that they play in 
Set track Raspberry Pi treats the Sense HAT joystick in a random order. 
Drag a set block above your play sound the same way as the arrow keys on your keyboard. Pushing the Sense 
block and choose track and 1. Click More Blocks This means that, for example, pushing the HAT joystick 
e a é i inwards means 
and drag a scroll message block under set track. joystick up is the same as pushing the up arrow ihe samething 
The scroll message block can use the track on your keyboard. to Scratch as 
variable with a join block. Drag a join block and Test your scripts again: click the green flag, and pressing ENTER 
then use the Sense HAT joystick to change the on the keyboard. 


Update the MP3 
player code so 
that when the 
joystick is pushed, 
the code chooses 
and plays a 
random track. 


volume of your music. 


V Step 8 Scroll the track number on the LED matrix 


Change tracks 

Now that you know how to use the joystick, 
it’s time to try to use it to change which track is 
playing. When the program starts, you will need to 
stop all sounds. 

Use thewhen left arrow is pressed and the 

when right arrow is pressed blocks to stop all 
sounds and to increase or decrease the value of your 
track variable. 


You can also use a scroll message block to show T The sense 
again which track is being played. You can use the a versatile piece of 
5 hardware made by 
when arrow is pressed blocks to change the value Raspberry Pi. It's 
stored in your track variable. called a Sense HAT 
ee 2 ý due to all the sensors 
That’s it - your MP3 player is complete! Click on on board (hardware 
H and motion), but 
the green flag and then have ago at changing your Seege other 
tracks using the Sense HAT joystick. 7 features here 
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WO FEATURE 


Add vision with the 


CAMERA 
MODULE 


A Raspberry Pi Camera Module should be an essential 
piece of any digital maker's kit, as it can be used in a wide 
variety of projects. Wesley Archer puts us in the picture 


ive your Raspberry Pi the gift of sight We’ve seen many exciting builds take advantage 
G with an official Camera Module of these, but being able to see what is happening 
(magpi.cc/xSXqyL). This handy add-on around your Raspberry Pi is very simple with 
connects directly to the Raspberry Pi and is used the Camera Module. These are some of the best 
in a wide range of vision-based projects. projects for beginners. They’ re easy to set up and 
Using a Raspberry Pi to monitor its produce visible results. 
surroundings is a fascinating subject, especially Using the Camera Module is a great way to 
with the huge array of sensors, accessories, HATs, add an extra dimension to most projects. Let’s 
and pHATs available. get started... 


Regular or w Camera Module V2.1 w Camera Module NolR V2.1 


night vision? 


En; 
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MO 
Ki 
m 
wi 


The Camera Module has two 
variants - the standard version 
and the Holp version, which 
has the infrared filter removed 
to allow the camera to detect 
infrared light. It makes a great 
night-vision camera when used 
with an IR light source! 


° 
IK02 94V. 
‘ 701: 


Raspberry Pi 
Camera V2.1 
Camera V2 


Made in PRC 
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FEATURE HER 


The Camera Module is small The small lens captures still 
enough to fit inside bird- images and video, which are 
boxes or small project boxes saved to Raspberry Pi 
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WO FEATURE 


SET UP YOUR 


| a 


CAMERA MODULE 


Before you can start snapping away with the Camera Mo 
you'll need to connect it to a Raspberry Pi and test it out 


You'll Need 


> Raspberry Pi 
Camera Module 
magpi.cc/ 
kAtsHn 


> Pi Zero Camera 


Adapter (optional) 


magpi.cc/ 
uAUbdp 


>microSD card 


> Raspbian 


Disable LED 


The V1 Camera 
Module lights a 
red LED when 
activated (the V2 
Camera doesn't 
have one). To 
disable this, add 
disable Camera 
led=1 to the 
/boot/config.txt 
file (and reboot). 


> While small, the 
Camera Module takes 
high-resolution photos 


(up to 3280x2464 pixels) 


and captures HD video 
(up to 1080p) without 
breaking a sweat 


etting up a Camera Module couldn’t be 
S easier. You attach the Camera Module 

directly to the Camera Serial Interface (CSI) 
port on the Raspberry Pi board. 

Connecting it to your Raspberry Pi is the same 
whether you own a Raspberry Pi 3A+/3B+, 4, Zero, 
or even an earlier Model B with 26 GPIO pins. 

However, if you are going to connect a Camera 
Module to a Raspberry Pi Zero (1.3, W, or WH), 
you’ll need to use a Pi Zero Camera Adapter. This is 
often sold separately (£4, magpi.cc/uAUbdp), and 
sometimes included with the Official Raspberry Pi 
Zero case (magpi.cc/LECcmF). 

If you received a Raspberry Pi Zero W free 
with a12-month subscription to The MagPi 

(magpi.cc/subscribe), you will have got a Zero 
Camera Adapter cable free with your Starter Kit. 

Once you’ve got your Camera Module and 
Raspberry Pi, you use the cable to attach the two 
together. Weill show you how... 


Connect the cable to 

a Raspberry Pi 2/3/3+/4 
On a full-size Raspberry Pi, you will need to 
connect the camera cable to the Camera port 
nearest the Ethernet port. Gently lift the small 
plastic clasp on the Camera port and connect the 
camera cable with the blue part facing towards 
the Ethernet port, then gently push the clasp back 
down so it holds the cable in place. 


2 Connect the cable 

to a Raspberry Pi Zero W 

The Raspberry Pi Zero W has a smaller Camera 
port, but the official Raspberry Pi Zero case usually 
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includes the cable. As with a full-size Raspberry 

Pi, gently pull the plastic clasp and then slot the 
camera cable in - you should see the white part 
facing upwards. You’ll know if the cable is in 
correctly if the camera works, but it is best to check 
before booting your Raspberry Pi. 


Connect the 

Camera Module 
Similar to the way the camera cable connects to 
Raspberry Pi, gently pull the small plastic clasp on 
the Camera Module and then slot the other end of 
the camera cable into the port - this time the blue 
part should be facing you, with the camera lens 
pointing the opposite direction. Gently close the 
clasp, locking the cable in place - the clasps can be 
fragile, so handle with care. 
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The cable connects 
the Camera Module to 
the Camera port ona 
Raspberry Pi board 


The cable is flexible, enabling you to position 
and attach the Camera Module wherever you 
want for your project. You can also buy different- 
length cables to suit your project 


Enable the Camera Module 

By default, the Camera Module is not enabled 
in Raspbian, but it is very easy to do this. If you 
have your Raspberry Pi connected to a mouse, 
keyboard, and monitor, you can use the Raspberry 
Pi Desktop to enable the Camera function. Click 
on the raspberry icon (top left) and choose 
Preferences > Raspberry Pi Configuration. Click the 
Interfaces tab and set Camera to Enabled. Click OK; 
when prompted to reboot, click Yes. 
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Enabling via SSH 

If you are accessing your Raspberry Pi over 
SSH, yov’ ll need to enable the camera via the 
command-line Raspberry Pi configuration tool 
instead. Enter the following in a Terminal window: 


sudo raspi-config 
Now select ‘5 - Interfacing Options > P1 - Camera’ 
and choose <Yes> to enable the camera. Press 
ENTER on <Ok> and choose <Finish>. When 
asked to reboot, choose <Yes>. We’re now set to 
snap away. 


Test the Camera Module 

Before diving into a project, it’s worth testing 
your Camera Module works as expected first. Open 
a Terminal and enter this command: 


raspistill -o /home/pi/hello. jpg 


Smile for a few seconds - you can see yourself on 
the live camera preview - while the photo is taken 
and saved to the /home/pi directory. Why not open 
it in File Manager to see the results? 


FEATURE HER 


A Raspberry Pi Zero 
owners will need a Pi 
Zero Camera Adapter 
to connect the Camera 
Module to the smaller 
Camera socket on 

the board 


Raspberry Pi 


Camera Case 


Using a full-sized 
Raspberry Pi? Why 
not buy a Raspberry 
Pi case designed to 
accommodate the 
Camera Module, 
such as the PiShell? 


4 You must activate 
the Camera interface 
in Raspberry Pi 
Configuration before 
using the camera 
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WO FEATURE 


CAMERA MODU 


SETTINGS 


Get the most out of your Camera Module by tweaking 
the various settings and creating different effects 


he Camera Module doesn’t just snap photos 
| - it also records video - but did you know 

that there are lots of different settings that 
can be applied to customise how the photo or video 
appears? In this guide, we’re going to explore some 
of the settings and commands that can be used 
to tailor how you use the Camera Module in your 
project, and we’ll explore some of the more quirky 
features too! 


1 Adjusting resolution 
and brightness 

The v2.1 Camera Module has a maximum resolution 
for a photo of 3280x2464 pixels, but images 

this large can take up a lot of storage space over 
time and take longer to process by Raspberry Pi. 
Fortunately, raspistill, the program that captures 
photos on our Raspberry Pi, allows us to specify 

the photo resolution very easily. For example, 

you can set the width (640 pixels) and height (480 
pixels) using the -w and -h parameters accordingly. 
You can also specify the brightness with the -br 
parameter and a value between 0 and 100. The 
image above was taken with the NoIR Camera 
Module (hence the odd colours) using: 
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raspistill -w 648 -h 488 -br 48 -o /home/ 
pi/hello. jpg 


This demonstrates how you can take a smaller 
photo (640x480 pixels) with a brightness of 40, but 
feel free to experiment to see what works best. 


Smera 12-10-2018 0950.03 


2 Adding text 


If you’re old enough to remember actual 
printed photographs, then you may have noticed 
that some cameras added the date and time 
to record when the photo was taken. If you’re 
too young to remember, don’t worry as you’ve 
just learned something new! With raspistill 
you can add your own text to your photos too, 
using the -a or --annotate parameter. Take the 
following example: 


raspistill -a 4 -a "Pi Camera %d-%m-%Y 
%X" -o /home/pi/text. jpg 


The first -a 4 part sets the bitmask notation in 
the metadata to record the time (more info on that 
here: magpi.cc/2egcYup). 

The second -a part includes our custom text 
(Pi Camera) and formats the date into dd-mm-yy 
(%d-%m-%Y) before adding the time (%X) and then 
saving the photo in our Raspberry Pi’s home 
directory (/home/pi) as text.jpg. 


FEATURE HER 
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Camera 


Essentials 


We've only just 
scratched the 
surface of what 
the Camera 
Module can do 

in our guide, so 
why not take 

a look at The 
Moof Essentials 
Camera Module 
Guide for a more 
comprehensive 
overview of all the 
commands, hints, 
and tips to ensure 
you get the most 
out of it? 


magpi.cc/ 
camera- 
essentials 


Add image effects 

Another quirky feature of raspistill is that 
you can add image effects to photos taken by the 
Camera Module, such as inverting the colours toa 
negative, making the photo look like a sketch, or 
even adding a cartoon effect. Now, before you all 
get carried away, some of the effects can be a little 
hit-and-miss, but they can add a cool look to your 
photos nonetheless! This is done by adding the 
-ifx parameter along with the desired effect (full 
breakdown available here: magpi.cc/SuuEC]J). 

The following example applies a negative effect 

to the photo, as well as adding our custom text, 
date, and time: 


<4 Make the photo 

look like a watercolour 
painting instead of a 
negative with the -ifx 
watercolour parameter 


<4 Embossing is the 
process of creating a 
raised image, usually 
in paper or card. You 
can recreate the effect 
with the -ifx emboss 
parameter 


As you can see from the image above, this is an 
interesting effect! Be sure to try out the sketch and 
emboss commands too. 
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WO FEATURE 


CAMERA MODUL 
PROJECTS ` 


We've selected six Camera Module-related projects to 
If you need some inspiration, then take a look at the pick 


Stop-motion animation 

Stop-motion animation - think Wallace & 
Gromit - is where a series of photographs are 
taken, but with minor changes made to the 
‘scene’ being filmed. The scene is changed 
slightly between shots - known as frames - 
and when they are all stitched back together 
afterwards, the illusion of animation is 
complete! In this fantastic tutorial, learn how to 
add a button to your Camera Module setup and 
create your very own stop-motion animation! 
More info: magpi.cc/KiYbdb 


Raspberry Pi Zero LED case hack 

As you now know, the NoIR version of the 
Camera Module has the infrared filter removed 
from the lens so that it can detect infrared light. 
This makes it an ideal choice for projects in the 
dark. In this neat project, you can easily add IR 
LEDs to provide additional infrared light, so that 
your pictures capture more detail in the dark - 
and all housed within the official Raspberry Pi 
Zero case, too! 

More info: magpi.cc/xCozST 


Rodak: a Raspberry Pi in a Kodak 
Taking photos is what the Camera Module is 
designed for, so what better way to do that than 
to upcycle an old Kodak Brownie Flash III camera 
to house a Raspberry Pi Zero, like Alex Ellis did? It 
also contains some additional components, such 
as a LiPo battery for power-on-the-go, a push- 
button to trigger the camera, and a cool NeoPixel 
status LED to show you when the camera is ready 
to fire again! 

More info: magpi.cc/sAxjyc 
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Google Vision: Camera Tell 

This cool project, by Dan Aldred (aka TeCoEd), 
makes use of the Google Vision cloud service. If you 
haven’t heard of Google Vision, it uses artificial 
intelligence to analyse an image and tells you 

what is in it! Dan takes this project even further by 
creating a portable camera - housed inside an old 
disposable camera - that uses aCamera Module, 

as well as Google Vision to announce what you have 
just taken a photo of. 


More info: mag] 
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Make a parent detector 
Do you suspect your parents sneak into your 


Home CCTV with motionEye0S room when you’re out? Do they play on your 

If you missed the Home Security feature in The Xbox or PS4 without your permission? Then 
MagPi 73 (magpi.cc/73), you should definitely follow this tutorial and build a parent detector, 
check out the handy motionEyeOS, which is using the Camera Module and a PIR (passive 

a standalone operating system that runs on infrared) sensor, and catch them red-handed! 
Raspberry Pi and allows you to easily create your Learn how the PIR sensor can trigger the Camera 
very own home CCTV setup with a few clicks. Once Module to take a photo whenever it detects 

the OS image is flashed to your microSD card, you movement, then see how your parents react 

will be up and running in no time and be able to when confronted with the evidence. 


keep an eye on your home when you are away. More info: magpi.cc/ 


More info: maor 
More inio: mag] 
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Dave 
Honess 


Dave lives in 

the Netherlands 
and works at 

the European 
Space Research 
and Technology 
Centre, where he 
helps coordinate 
the educational 
operations for 
European crew on 
the ISS. 


@dave_spice 


| You'll Need 


> Raspberry Pi 2B or 
later 


> 3.5mm speakers or 
headphones 


» RTL-SDR USB 


dongle (search for 
‘RTL2832U’) with a 
good whip or dipole 
antenna (or just 

get this starter kit: 
magpi.cc/uBMKQg) 


> Tape measure, at 
least 1 metre 


Pictures from space 
via ham radio 


Have you ever wanted to receive a radio signal from space? 
It's fun and a lot easier than you might think! 


hat is Slow Scan TV (SSTV), then? You 
W convert a picture into sound (similar to 

fax machine or dial-up modem noise) 
transmit the sound via radio, and convert the 
received sound back into a picture at the other 
end. The International Space Station (ISS) has 
a long history of transmitting SSTV pictures for 
global events, each lasting several days, where 
people the world over tune their radios to the ISS 
and try to receive the pictures every time it flies 
over their home. It’s a hobby of mine! 

One such event began on 12 April 2019 to 
celebrate the anniversary - to the day - of the 
launches of Yuri Gagarin in 1961 and the first 
Space Shuttle, 20 years later, in 1981. 


Install prerequisites 

and set the time 
We presume you are running a clean install of 
Raspbian and are online. 


NASA On The Air 


Apollo 16 


A This is one of the clearest pictures your author has been able 
to receive with this setup. It was from an 83 degree elevation 
pass near Amsterdam, in the Netherlands, on 15 February 2019 
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Firstly, switch the audio output to the 3.5mm 
headphone jack. This is needed for the way 
PulseAudio loops back the system audio asan 
input device. On the Raspbian desktop, simply 
right-click the speaker icon in the menu bar and 
choose Analog. 

Then, open a Terminal and install the required 
software for the project: 


sudo apt-get update 
sudo apt-get install rtl-sdr sox 
pulseaudio qsstv ntpdate -y 


Next, set your time zone and pull the correct time 
from the internet. In the Raspbian main menu, 
go to Preferences > Raspberry Pi Configuration > 
Localisation tab > Set Timezone, change Area and 
Location accordingly, then click OK. 

Finally, go back to the Terminal window to pull 
the time: 


sudo ntpdate pool.ntp.org 


Note that the desktop clock in the top right only 
updates every minute. 


Install and test 

the RTL-SDR dongle 
Insert the RTL-SDR dongle into your Pi and screw 
in the antenna (it can sit on your desk at this 
stage). Then verify the RTL-SDR is working with 
the rtl_test program. In a Terminal window, enter: 


rtl_test 


If you see a ‘failed to open rtlsdr device’ error, 
remove the dongle, reinsert it, and tryrtl_test 


H 


A lt takes about two whole minutes for a picture to be decoded 
When they do this from the ISS, a picture is transmitted 
continuously for about two minutes, with two minutes of 
off-time before the next picture starts 


again. Leave for about 30 seconds and look out for 
any messages about loss of samples. Press CTRL+C 
when 30 seconds has elapsed. The loss of 100 bytes 
or so is acceptable. 


Listen to a commercial 

FM radio station 
Let’s tune into a commercial FM radio station to 
check that both the dongle and the antenna are 
working correctly. The command below pipes 
raw data from rtl_fm into ‘play’, which will then 
produce the audio output. Modify the value after 
the -f to specify your own FM station/frequency 
and don’t forget to put the capital M after the 
number so it knows you mean megahertz and not 
hertz (98.8MHz is BBC Radio 1 in the UK). Ina 
Terminal, enter: 


rtl_fm -M wbfm -f 98.8M | play -r 32k -t 
raw -e s -b 16 -c 1 -V1 - 


Note that the ‘Tuned to’ value in the output 
doesn’t match. This is due to a property of all 
SDR hardware, called ‘DC spike’, and can be 
ignored. Plug in your speakers/headphones and 
you should now be able to hear audio from the 
commercial FM station. Move the antenna around 
or select a different FM radio station with a closer 
transmitter if the audio is noisy. Press CTRL+C to 
quit from rtl_fm. 


Set up QSSTV 

QSSTV is the program that will listen to 
the audio output on the Raspberry Pi and decode 
the pictures from the fax/modem noise when the 
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This inexpensive 
USB dongle acts as 
the radio receiver 


This is a good, but 
cheap, antenna 
which can pick up 
the ISS SSTV signal 


ISS is in range. Let’s just check the settings are all 
correct. In the main menu, select Internet > QSSTV, 
then select Options > Configuration and choose the 
following options in the Sound tab: Play with SSTV 
on mobile 
Audio Interface - PulseAudio 

Input and Output Audio Device - default -- Playback/ 
recording through the PulseAudio sound server 
Sound Input - From sound card 

Sound Output - To sound card 


For a quick test, 
you can try these 
free mobile 

apps: Robot36 on 
Android; CQ SSTV 
on iOS. Play this 
MP3 (magpi.cc/ 
ruANWC) and put 
the phone near 
the speaker. 


Click OK. Next, run the Calibrate function and go 
make a cup of tea/coffee: Options > Calibrate. Click 
OK when both progress bars reach 99%. 


Decode a picture from test audio 

Now that QSSTV is set up, we can download 
a test audio file, play it, and see a picture slowly 
appear. Ina Terminal, enter: 


wget https://raw.githubusercontent.com/ 
davidhoness/sstv_decoder/master/sstv_test.mp3 


Select the Receive tab in QSSTV and choose the 
following settings: 


Use VIS-on 
Auto Slant - on 
Autosave - on 
Signals - Normal 
Mode - Auto 
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RTL-SDR 
starter kit 


Your author 
personally 
recommends 

this starter kit 

that comes with 
the USB dongle 
and a good 
v-dipole antenna: 
magpi.cc/uBMKQg 


V Imagine holding this 
picture above your 
head and aligning 
it with the compass 
directions. The line 
shows the flight path 
of the ISS across the 
sky above you 


Click the play > button. Nothing will happen, but 
just click it to start the receiver. 

Open sstv_test.mp3 in the Chromium browser. 
You can either drag and drop the file from File 
Manager, or enter file:///home/pi/sstv_test.mp3 
into the address bar. 

Let it play and watch the picture appear in QSSTV. 
Notice the waveform and waterfall display activity on 
the right of the screen. Other SSTV test recordings 
can be found online, such as: magpi.cc/dXpjRr. 


Prepare for the next SSTV event 
To get pictures from the ISS you need to 
know three things: 


- When the ISS will be transmitting the SSTV 
signal. It’s not always-on. 

- What frequency the SSTV signal will be 
transmitted on (usually 145.8MHz). 

- When the ISS will fly over your location. 


The ISS flies over most places a few times every 
day (unless you live in the Arctic/Antarctic). You 
can find out when the ISS is transmitting on this 
website: ariss-sstv.blogspot.com. 
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At the time of writing, for instance, an SSTV 
event was scheduled to start on 4 August 2019 
to honour NASA astronaut Owen Garriott, the 
first person to operate amateur radio from space. 
These events usually last for a few days at a time, 
meaning you will get multiple ISS passes during 
which you can receive the SSTV signal. 


07 When is the ISS flying over me? 
There are many websites you can use 
for this, but your author’s personal favourite 
is heavens-above.com. 

Click ‘Unspecified’ in the top right to set your 
location. Type your postal code and country into 
‘Enter place to search for’ and click Search. Scroll 
down and click Update. You’1l now be back on the 
homepage; under Satellites, click ISS. For ‘Passes 
to include’, select ‘all’. 

The table now showing lists the times of the 
upcoming ISS passes for your location. The Alt 
value under ‘Highest point’ is the maximum 
elevation of the pass above the horizon; 90 would 
mean it goes directly overhead. Passes with higher 
maximum elevation will give better results than 
lower ones. Clicking on any row in the table shows 
the sky chart for that pass. Imagine holding that 
picture above your head and aligning it with the 
compass directions. The line shows the flight path 
of the ISS and this is useful for roughly positioning 
your antenna. It can also be useful to look at the 
‘Ground track’ (see link in top right). Plan ahead 
and set up your ground station with time to spare 
before the ISS flies over. 


Adjust your antenna 
If you are using the RTL-SDR kit 
antenna, please read the getting started guide for 
it: magpi.cc/qzUKtZ. 
It’s a good idea to adjust the length of the 
telescopic arms based on this dipole calculator 
(magpi.cc/uGNNxP) to match the antenna’s 
resonant frequency to 145.8MHz. This will help 
pick up weaker signals from low elevation passes. 
Under Desired Frequency, enter 145.8. Under 
Select Antenna Calculation, select One Side. Click 
Calculate. The answer should be 48.9cm. 
Remember, there is about 2cm of metal in each 
side of the antenna base. So take 48.9 and, before 
screwing in the arms, use a tape measure to make 
them both this length minus 2cm (excluding the 


screw threads). It doesn’t have to be perfect, but 
make it as close as possible. 


Deploy your antenna 

As a general rule, try to get your antenna 
up as high as possible with a good view of the 
sky in all directions. Outside is always better, but 
you can still get the signal from inside a house - 
you’ ll just see more noise in the pictures. Then, 
with the dipole arms flat, roughly align them 
with the flight path of the ISS that you find on 
heavens-above.com and bend the two arms 
upwards into a right-angle V-shape. You don’t 
need to realign it for every pass, but it will yield 
better results if you do. 

Antennas and their performance are sometimes 

a bit of an art form as opposed to an exact science. 
Experiment with different configurations on 
different ISS passes. Try one arm horizontal and 
one arm vertical, for instance. 


Set the correct time again 

QSSTV saves the decoded images with a 
UTC time file name and this is useful later when 
working out which ISS passes they are from. Ina 
Terminal, enter: 


sudo ntpdate pool.ntp.org 


Tune into the ISS frequency 

We’ll use rtl_fm again for this, but note that 
the command is different to the commercial radio 
station one. A commercial radio station uses wide 
band FM whereas the ISS SSTV transmission uses 
narrow band FM and so we have to set rtl_fm up 
differently. In a Terminal, enter: 


rtl_fm -M fm -f 145.8M -s 48k | play -r 
48k -t raw -e s -b 16 -c 1 -V1 - 


You should be able to hear white noise now (don’t 
forget the capital M for megahertz), but this will 
change to the fax/modem noise when the ISS 
flies over with the transmission active. Keep this 
window open. A picture is transmitted from the 
ISS continuously for about two minutes, with 
another two minutes of off-time before the next 
picture starts. 
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Start QSSTV 
In the Raspbian main menu, select Internet 
> QSSTV. Select the Receive tab in QSSTV and 
choose the following settings: 
Use VIS - on 
Auto Slant - on 
Autosave - on 
Mode - Auto 
Save if Complete (%) - 10 


Click the play ® button. The waveform and 
waterfall display on the right should show noise 
coming from rtl_fm. Leave QSSTV running. 


The ARISS VHF 
antenna installed on 
the bottom of the 
Columbus module 
Credit: NASA/ESA 


m Antennas and their performance are 
sometimes a bit of an art form as opposed 


to an exact science U 


What is Doppler shift? 

A common example of Doppler shift is 
the change of pitch heard when a police car or 
ambulance speeds past you. Compared to the 
emitted frequency of the siren, the frequency you 
hear is higher during the approach, identical at the 
instant of passing by, and lower during departure. 
The same thing happens with radio waves as with 
sound waves. The ISS is moving at 7km per second! 

To compensate for this, ground stations must 

continually retune their receiver as the ISS 
approaches (starting ~3.5kHz above 145.8MHz), 
passes overhead (reaching 145.8MHz exactly), 
and flies away (ending ~3.5kHz below 145.8MHz). 
The good news is that QSSTV is clever and can 
compensate by tracking the centre frequency of the 
audio signal as the ISS flies over. So you don’t need 
to do anything! 


TopTip è 


Antennas 
to avoid 


Avoid the little 
30cm mag- 
mount antennas 
that often come 
with these RTL- 
SDR dongles. 
You will have 
little or no hope 
of picking up the 
ISS with them. 
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David Homess MEONT 


> Language: Python 


001. #!/usr/bin/python3 
082. import urllib.request 
083. import math 

084. import socket 

085. import ephem 

086. import time 

087. import sys 


A You can potentially get a certificate like this, even if you only 


decode a few lines of one picture 088. import ssl 
089. 
018. 
Compensate for @11. C = 300000000.0 
Doppler shift (optional) 012. FØ = 145800000.0 
It doesn’t make much difference, but if you 013. 
want to have some fun with this, your author 014. LATITUDE = "52.219308" 
has created a Python script to compensate for 015. LONGITUDE = "4.419926" 
Doppler shift. It tracks the ISS using ephem, 016. ALTITUDE = 20 
computes the corrected frequency for when the 017. 
ISS is passing over, and retunes rtl_fm using a 018. 
UDP socket: magpi.cc/zNtRDB. 019. class tle_reader(object): 
To use it you’ ll first need to run sudo pip3 020. ma 
install ephem and then just start the script 021. For keeping ephem two line element sets up to date 
in another Terminal window. But first you will 022. SC 
need to modify the code to set your location. 023. def _ init__(self, 
See the LATITUDE, LONGITUDE, and ALTITUDE 024. tle_name="ISS (ZARYA)", 
variables at the top. Get the values from the top 025. tle_file= 
right of heavens-above.com and just estimate "https://celestrak.com/NORAD/elements/stations.txt", 
your altitude. 026. tle_max_age=3600): 
027. self. le name = tle_name 
028. self._tle_file = tle file 
029. self._tle_max_age = tle_max_age 
Wait for the ISS to arrive 030. self. tle = None 
You may want to leave your ground station 031. self.reload() 
overnight or over the weekend to capture several 032. 
passes. When you return, select the Gallery tab 033. def build _index(self, tle_lines): 
in QSSTV to see what images were received. 034. index = {} 
Alternatively, it’s always exciting to watch the 035. for i in range(@, len(tle_lines), 3): 
pictures coming in live as the ISS is above you! 036. index[tle_lines[i].strip()] = (tle_lines[i + 
1], tle_lines[i + 2]) 
037. return index 
038. 
Get an SSTV award! 039. def reload(self): 
On your Raspberry Pi, the decoded pictures 040. print("Loading: %s" % self._tle_file) 
can be found in /home/pi/qsstv/rx_sstv. You can 041. 
upload them on this website for verification and 042. try: 
recognition: magpi.cc/Kdjnmy. 043. ctx = ssl.create_default_context() 
Check the information for the event on 044. ctx.check_hostname = False 
ariss-sstv.blogspot.com to find out how to apply 045. ctx.verify_mode = ss1l.CERT_NONE 
for the award certificates. This will be a PNG file 046. with urllib.request.urlopen(self._tle_file, 
that is emailed to you and will show a unique context=ctx) as response: 


number. Good luck! H 
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DOWNLOAD 
THE FULL CODE: 


© magpi.cc/zNtRDB 


047. tle_lines = response.read().decode( 0892. self._s.send(cmd_bytes + param_bytes) 
"utf-8").splitlines() 093. 

048. index = self.build index(tle_lines) 894. def _del_ (self): 

049. tle_data = index[self._tle_name] 095. self._s.close() 

050. self._tle = ephem.readtle( 896. 
self._tle_name, tle_data[d], tle_data[1]) 0897. 

051. except Exception as e: 098. rtl = rtl_fm_remote() 

052. print(e) 899. iss = tle_reader( 

053. tle_name="ISS (ZARYA)", tle_max_age=5520) 

054. self._tle_age = time.time() 100. 

055. 101. if iss.tle is None: 

056. @property 102. sys.exit(®) 

057. def tle(self): 103. 

058. return self._tle 104. myloc = ephem.Observer() 

059. 105. myloc.lon = LONGITUDE 

060. @property 106. myloc.lat = LATITUDE 

861. def tle_expired(self): 187. myloc.elevation = ALTITUDE 

062. return time.time() - self._tle_age > 108. 
self._tle_max_age 109. freq = Fe 

063. 110. running = True 

064. 111. 

@65. class rtl_fm_remote(object): 112. try: 

066. SE 113. while running: 

067. For remote control of rtl_fm command line program 114. myloc.date = time.strftime( 

068. SEH '"%Y/%m/%d %H:%M:%S', time.gmtime()) 

0869. def _ init__(self, 115. iss.tle.compute(myloc) 

078. host="localhost", 116. alt = math.degrees(iss.tle.alt) 

071. port=602@): 117. 

072. self._host = host 118. if alt > @: # iss is flying over location 

073. self._port = port 119. new_freq = int( 

074. self._s = socket.socket( F@ - iss.tle.range velocity * FO / C) # doppler 
socket.AF_INET, socket.SOCK_DGRAM) 120. if new_freq != freq: 

075. self._s.connect((self._host, self._port)) 121. print( 

076. new_freq, round(alt, 2), myloc.date) 

077. def set_freq(self, freq): 122. rtl.set_freq(new_freq) # set new 

078. self.send_cmd(®, freq) frequency in rtl_fm 

079. 123. freq = new_freq 

080. def set_mode(self, mode): 124. elif iss.tle_expired: 

081. self.send_cmd(1, mode) 125. iss.reload() # we could be running for 

082. days / weeks 

083. def set_squelch(self, squelch): 126. else: 

084. self.send_cmd(2, squelch) 127. time.sleep(10) # do nothing, wait for 

085. iss to arrive 

886. def set_gain(self, gain): 128. freq = FO 

087. self.send_cmd(3, gain) 129. except KeyboardInterrupt: 

088. 130. running = False 

089. def send_cmd(self, cmd, param): 131. 

898. cmd_bytes = (cmd).to_bytes(1, "little") 132. print("Bye") 

091. param_bytes = (param).to_bytes(32, "little") 
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All Raspberry Pi models have a 

composite out port to connect 
analogue devices. Model B+ and later 
combine the audio out and composite 
out on to the same 3.5mm jack plug. 
This requires a particular type of lead, 
with audio left on the tip, audio right 
on ring 1, ground on ring 2, and video 
on the sleeve. See magpi.cc/tDfjLV. 


The HDMI port outputs audio 

as well as video. If your display 
lacks a built-in speaker, you’ ll want 
to use the speaker jack. If so, right- 
click on the volume icon in the menu 
bar and switch from HDMI to Analog. 
Alternatively, use the command line: 


amixer cset numid=3 1 
Set the last number to ‘1’ for Analog, 
or ‘2’ for HDMI. Use raspi-config to 
change the audio setting at boot: 
sudo raspi-config 
Choose Advanced Options > Audio and 


‘Force 3.5mm (‘headphone’) jack’ or 
‘Force HDMI to set this as the default. 


The power requirements of your 
Raspberry Pi increase as you 
make use of the various interfaces. 
The GPIO pins can draw 50 mA safely, 
distributed across all the pins; an 
individual GPIO pin can only safely 
draw 16mA. The HDMI port uses 
50mA, the Camera Module requires 
250 mA, and keyboards and mice can 
take as little as 100 mA or quite a bit 
more. Buy the Official Power Supply 
and check the power rating of your 
devices: magpi.cc/xfszUR. 


You can use a webcam, but 
Raspberry Pi has a dedicated 
option: the Camera Module 
(magpi.cc/jbKzbf). This is attached 
to the CSI (Camera Serial Interface). 
The Camera Module is used to take 
high-definition video and still 
images. It’s easy to use for beginners, 
but has plenty to offer advanced 
users if you’re looking to expand 
your knowledge. There are lots of 
examples online of people using it for 
time-lapse, slow-motion, and other 
video cleverness. You can also use the 
libraries Raspberry Pi has developed 
to create visual effects. 


A Raspberry Pi Touch Display 
(magpi.cc/CAPxtI) gives users 
the ability to create all-in-one, 
integrated projects such as tablets, 
infotainment systems, and embedded 
projects. Its ribbon cable connects to 
the DSI port present on all Raspberry 
Pi boards (except Raspberry Pi Zero 
and Zero W). 


Open a Terminal and enter: 
pinout 


...for a quick visual guide to the GPIO 
pins. Or enter: 


pinout -x 


...to open the web browser and point it 
to the interactive model at pinout.xyz. 


You can see the mechanical 
drawings for Raspberry 

Pi 3B+ (and all other models) 

on the Raspberry Pi website: 
magpi.cc/WWFUji. 


Many Raspberry Pi models 
feature a wireless LAN adapter 

to connect to local network. But you 
can also use the access point to create 
a wireless hotspot. The process is a 
little long, but it’s great for learning 
more about how wireless LAN works. 
Read more at magpi.cc/nnriRT. 
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sudo apt-get update 
sudo apt-get install xscreensaver 


cd /opt/vc/src/hello_pi 


./rebuild.sh 


cd hello_tiger 
./hello_tiger.bin 


sudo nano /boot/config.txt 


vcgencmd get_config <config> 


Pi@raspberrypi: /opt/ve/sre/hello_pi 


vcgencmd get_config arm_freq 


vcgencmd get_config int 


vcgencmd get_config str 


Free up space 

You can save space on your microSD card 
for projects, documents, and code by 
removing some of the programs provided in 
Raspbian by default. You can remove software 
from the command line: 


sudo apt purge mathematica 
sudo apt clean 
sudo apt autoremove 


But it's much better to choose Menu > 
Preferences > Recommended Software. Clear 
the tick next to the unwanted program and 
click OK. 


Kernel update (& rollback) 
If you use the standard Raspbian update/ 
upgrade process, this will automatically 
update the kernel to the latest stable version. 
This is the recommended procedure. However, 
sometimes you may wish to update to the 
latest ‘bleeding edge’ or test kernel. 


sudo rpi-update 


The rpi-update utility will download the 
latest (unstable, testing) kernel version and 
copy all required files onto your system. Note 
that the latest kernel from rpi-update is 

not guaranteed to work correctly! Make sure 
that it doesn’t conflict with your distribution 
packages. It doesn’t provide a way of 
automatically uninstalling the files. 

To revert to the current stock Raspbian 
kernel after trying rpi-update or a custom 
kernel, you need to reinstall both these 
packages, by running: 


sudo apt-get install --reinstall 
raspberrypi-bootloader raspberrypi- 
kernel 
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Change your password 
With the standard install of Raspbian, the 
default username is piand the password is 
raspberry. If you haven’t at least changed this 
password, anyone can log into your Raspberry 
Pi! Go to Menu > Preferences > Raspberry Pi 
Configuration. In the System tab, click Change 
Password, enter one, confirm it, and click OK. 


Keep Raspbian up to date 
From time to time, security 
vulnerabilities are found in software, so 
it’s always best to get the latest versions ona 
regular basis. In a Terminal, type sudo apt- 
get update to update your package lists, then 
sudo apt-get dist-upgrade to get the latest 
version of the packages on your system. 


Install Fail2ban 

If someone wants to hack into a Raspberry 
Pi, they may try to guess your username 
and password. It will probably take a lot of 
attempts, but this is called ‘brute-forcing’. To 
prevent this, you can installa program called 
Fail2ban. Install using sudo apt install 
fail2ban and a user will be banned for ten 
minutes if they fail login five times. 


Change default SSH port 

If you change the default SSH port, 
anyone trying to connect would need to 
know which port to use. To alter it, sudo nano 
/etc/ssh/sshd_config and change the line 
#Port 22 to read Port 2222 (without the #) or 
another memorable number. Save and exit 
(CTRL+O, ENTER, CTRL+X), then restart SSH 
with sudo service ssh restart. 


Turn off interfaces 

you don't need 

The safest way to stop hackers is to not 
have any network connection, but another way 
of shutting down the system a bit more is to 

go into Main Menu > Preferences > Raspberry 

Pi Configuration and select the Interfaces tab. 
Make sure everything you don’t need is disabled. 
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sudo apt-get update 
sudo apt-get install fritzing 


sudo apt-get upgrade 
sudo apt-get install arduino 


Your Next Challenge... 


rie 


A Bach Uy 


4 Allies 


d gain new allies! 


One of the best ways to boost your 
programming skills is to complete 
challenges. If you are looking for some 
programming challenges, then sign up for 
Codewars on your Raspberry Pi. The website 
(codewars.com) has a video game style, and 
you get points and advance through levels by 
completing challenges (kata). We’ve even seen 
the latter being used in job interviews and to 
gain entry to coding boot camps. 


There’s a technique to soldering wires 

together called the ‘Western Union’ or 
‘Lineman’ splice, and you should learn it if 
you’re going to solder (magpi.cc/mckKVW). It 
was developed during the introduction of the 
telegraph (hence the name), and the wrapping 
pattern is designed to tighten as the two ends 
pull against each other. 


N 


2 7 We can’t recommend highly enough 

KI putting together a maker kit. This should 
contain a wide range of electronics parts, bits, 
and tools. Find a good components case and 
put in it a selection of resistors, capacitors, 
LEDs, buttons, potentiometers, a piezo buzzer, 
and a breadboard with lots of jumper cables. 
You can pick up kits and parts from most 
Raspberry Pi resellers, or visit the Raspberry 


and moves ali of the zei 


Sp 


kd 
A A PRG) 1 


38 to the end preserving the 


Pi store in Cambridge. We use a half-size 
breadboard in our diagrams, so if you get that 
type you’ll find it much easier to follow our 
projects: magpi.cc/dXHByV. 


Codewars is a good 
web resource for 
practising and flexing 
your programming 
muscles 


Learning the 
‘Western Union’ 
splice technique will 
make your soldering 
joints stronger 


ES 
aN 


Get to know your local second-hand 
(‘thrift’) store. Used objects can be a 
great source of inspiration, and upcycling old 
tech with new Raspberry Pi parts is a popular 
pastime. High-profile maker Martin Mander 
has rescued old radios, televisions, and toys. 
Follow him on Twitter (@MartinWMander) 
for inspirational ideas. A 
The best way to get inspiration and help f 
for your project is to share it with the 
Raspberry Pi community. In March 2019, 


S S E> He 
The MagPi ran #MonthOfMaking on Twitter, to 
encourage readers to share projects with one 
another. But don’t wait till next year - share LD=messsam-T7: 


your project on our forum (magpi.cc/forum), 
Facebook (magpi.cc/facebook), or Twitter 
(@TheMagPi). The more other readers see your 
project, the more likely you’ll be to finish it. 


Element14 has two collections of Tips for 
Makers packed with interesting ideas. 
Sign up with the Element14 website to access 
them: magpi.cc/XQaCyC. 
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You'll Need 


Network cable 
Internet router 


Internet connection 


You can use the 
curl tool to download 
files, such as PDFs of 
The MagPi issues 


g? Here are 5 
interesting H 


Raspberry Pi has two standard ways of 
connecting to a network: with an Ethernet 
cable or on-board WiFi (on newer models). 
The Ethernet cable is usually either a Cat5e 

or Cat6 (for fast networks) type, with an RJ45 
connector on each end. One end plugs into a 
router or hub and the other end into Raspberry 
Pi. Wired connections are generally faster 
than WiFi and will connect as soon as the 
cable is plugged in. Home wireless network 
connections can usually be connected to by 
just selecting the network and typing ina 
password - see magpi.cc/HiDkyk. 


An IP (Internet Protocol) address is a 
number allocated to your Raspberry Pi 


so that other computers know where to find 
it on the network. There are several ways to 
find your Raspberry Pi’s current IP address. 
In a Terminal window, there are a couple of 
commands you can use. The old command 
(which still works) is MAZAR. There is a 
new shorter command now, BI. which will 
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provide similar information. Your local 
IP address will be the number that looks 

something like 192.168.0.34. You can also 
find your IP address by hovering over the 
network icon (top right) of your desktop. 


The terms IPv4 and IPv6 are descriptions 
of the internet protocol and address. 
IPv4 uses 32-bit numbers for the address 
and looks something like: 192.168.1.23. As 
the internet has now grown so large, the 
limited number of available IPv4 addresses 
has become a problem. A new version of 

IP (IPv6), using 128 bits for the IP address, 
has been defined. In July 2017, the final 
definition of the protocol was published, 
although IPv6 has been in use for over 20 
years. An IPv6 address looks something like: 
fe80:94c:38c8:4600:7b33:64bb:baf7:e866. On 
a home network you will normally be using 
IPv4 format addresses, but look out for that 
to change in the future. 


You can do quite a lot with network 
commands in the Terminal. Some 
commands need to be installed first. The 
ping command is there by default. If you type 
SER] and then either an IP address or a web 
domain, it will tell you how long it takes to 
send a message to that computer/server and 
then get a reply. Cat is also pre-installed. 
Type 

to see the status of your WiFi connection. 

IS EIER apt-get install | 
MEE and then type MIZE with a domain 


name and you will find the registration 
details of that domain. 


Raspberry Pi has several files where 

it holds details about networking. It’s 
quite useful to know where some of these 

are, as you may need to change some of the 
information for custom configurations. The 
file /etc/hosts has a list of names that map 

to IP addresses. You could have an entry that 
says ‘192.168.0.3 myserver’ and that would 
mean that if you typed ‘myserver’ into a web 
browser address bar, the network would try 

to connect to 192.168.0.3. Other useful files 
are /etc/networks, which has network names 
mapped to IP addresses; /etc/protocols, which 
has a list of all the network protocols that can 
be used; and /etc/services, which has a list of 
all the network services available. 


If you want to know what’s happening 
between your Raspberry Pi and the rest of 
the network, there are a few commands you can 
install. A simple stats command is available 
with sudo apt-get install vnstat. When 
you run this command, it will give you some 
basic data transmission totals. If you want 
some extra tools, you could install iptraf-ng, 
which has a menu of different tools and filters 
to analyse the network traffic. To see some 
real-time data transfer stats, install bmon, 
which shows data quantities per second. 


Although Telnet is a very old networking 
system (first designed in 1969), it is still 
available and can be installed on Raspberry Pi 
using sudo apt-get install telnet. Telnet 
is abit like a very early version of websites 
and when this is installed, your Raspberry Pi 


E casper pi ~ 


IP traffic 


Configure 
bout 


Move selector 


can connect to any Telnet server. For example, 
enter telnet towel.blinkenlights.nl 23 

to see an ASCII version of Star Wars, or try 
telnet mtrek.com 1701 for a Star Trek 

game. There are lots of Telnet sites still 

out there, some of which can be found at: 
telnet.org/htm/places.htm. 


PiServer is a useful tool for networking 
many Raspberry Pi boards together 
without needing SD cards in them. For info on 
how to set it up, go to magpi.cc/RQDQXx. 


You can download files directly in the 
Terminal with the curl tool. Use curl -0 
<URL>. See magpi.cc/JrKoTA for more info. 


If you use the Raspberry Pi in a ‘headless’ 
mode (without the Raspbian interface), it 
can be tricky to connect to a wireless network. 


file for your particular wireless network and 
put this file in the boot folder. See here for 
more information: magpi.cc/RHviuV. 


m. @raspberrypi ~ 


You will need to define a wpa_supplicant.conf 


You can use lots 

of different tools 

to find out about 
your Raspberry Pi 
network connections; 
you can even play 
online games in the 
Terminal window! 
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To only proceed if the previous command 
has succeeded: 


For example: 


Applications in Linux systems, 

such as Raspbian, have three ways 

of communicating with you and other 
applications: standard in (stdin), standard 
out (stdout), and standard error (stderr). 
Output from a command-line application 
arrives on stdout and you can use the pipe 
character ‘|’ to send that output directly into 
another application, like this: 


...will create a directory, move into it, and 
open up the nano text editor with a new file, 
myFile.txt. You can save this line somewhere 
for future use or create an alias (see Tip 47). 


Here we get a long-form listing of the current 
directory and pipe that output into ‘wc’, a 
counting application. The Bl argument means 
‘count the lines’, so we now have a ‘new’ app 
that tells us how many items are in a directory. 
You can chain as many commands as you wish 
to achieve complex tasks. 


Running a command ‘in the background’ 
enables you to issue other commands 
while it works. If you’re using the Desktop, 
the simplest solution is to open another 
Terminal window. Alternatively, to have 

a process run in the background, add an 
ampersand (&) at the end of the command: 


This works well, but any output to stdout and 
stderr will appear on your console screen. To 
avoid this, use ‘nohup’: 


Now all output is written to nohup.log in 
your current directory. 


Try this: 


The command downloads a cat image - but 
you’re on the Terminal, which can’t show 
graphics. The image arrives as a lot of 
nonsense on stdout. We can use redirection to 
save itasa file like this: 


The ‘>’ operator tells Raspbian to put 
everything arriving on stdout into the file 
instead of your screen. You can also use ‘>>’ 
which appends to an existing file, or ‘<’ to 
feed the contents of a file into a command. 


Sometimes when a process is generating 
output, you might need to follow what’s 
happening. For example, your web server isn’t 
working quite right, so you can troubleshoot 
the problem by looking at the logs. To show 
the contents of any file on-screen: 

You can put multiple commands 
together on a single line so that they | cat texttxt 
execute one after the other: 
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However, if the log file is huge, you’ ll struggle Raspberry Pi 3 Model B Plus Rev 1.3 


to cope. To show the file in ‘pages’: 


un 4 Raspberry Pi Software Configuration Tool (raspi-co 
less text.txt Change User Password 
Network Options 

Boot Options 
Localisation Options 
Interfacing Options 
Overclock 

Advanced Options 


Change password for the curry 
Configure network settings 
Configure options for start-up 
Set up language and regional sett 
Configure connections to peripher 
Configure overclocking for your P 
Configure advanced settings 


To just see the last few lines: 


tail text.txt 


Best of all, to ‘follow’ the log file as it grows: 


tail -f text.txt 


A miscellany of shortcuts 
Tilde - The tilde character ‘~’ always refers 
to your home directory in paths. So cd ~ 
always takes you home (as does cd on its own). 


TAB autocompletion - Whenever possible, 
Raspbian will attempt to complete the 
command name you are typing. Try typing whoa 
followed by TAB. It will expand to whoami. This 
also works for paths. 


History - Forgotten that command? Your 
Raspberry Pi is keeping track. Pressing the up 
arrow key repeatedly goes through previous 
commands. Or run history to get a full list. 


!! - Two exclamation marks means ‘the 
previous command’. Forgot to use sudo? Don’t 
type the command again, just enter sudo !!. 


Using aliases 

If there’s a long command you’re going 
to be using a lot, create an alias for it. 
Aliases are kept in a hidden file (non-existent 
by default) called .bash_aliases, in the home 
directory. To create or view contents: 


nano ~/.bash_aliases 


For each alias you want to create, enter a line 
following this pattern: 


alias howmany="1s -1 | wc -1" 
Now you can run howmany for that command. 


It’s got stuck! 
Stuck with a crashed program on your 
screen? To gain access back to the 
prompt, try CTRL+C to stop the process, or 
CTRL+Z to put it in the background. Now enter 
killall <commandname>. You can use ps ax to 
show a list of running processes. Still there? 
Trysudo killall <commandname>. As a last 
resort, use sudo kill -9 <processid> (get 
the process ID from ps ax). 


Update 


WONDA UW A WN 


Some command- 
line applications 
take on a basic 
graphical 
appearance to 
make them easier 
to use. The most 
likely you are to 
see is raspi-config 


About raspi-config 


Update this tool to the latest ve 
Information about this configurat 


<Select> <Finish> 


Find out more 
Many commands come 

with a huge array of ‘arguments’ that 
control behaviour. These are in the form of 
‘switches’ (simple flags) or ‘parameters’ that 
provide additional info such as an input file. 
Most commands have an accompanying ‘man’ 
page (short for manual). To see if a ‘manpage’ 
exists for your command, just enter: 


man command 
You can even learn about ‘man’ itself: 
man man 


Alternatively, many commands respond to the 
switch --help (or -h for short) to provide a 
summary of options. 


Get in remotely 

We’ve all been there: happily working 
away in Raspberry Pi Desktop and 
something goes awry. Now the screen has 
locked up, your Doom high score is lost, and 
the only option is to unplug your Raspberry 
Pi, which risks data corruption. Well, you 
may be able to get in using SSH, which allows 
you to log into your Raspberry Pi (so long as 
you’ve already enabled SSH on it) from another 
computer and get to the command line: 


ssh raspberrypi.local 
Then, if you get to a prompt: 
sudo shutdown -h now 


...and your Raspberry Pi is rescued. H 


Get Started with Raspberry Pi @ | 87 


Ms TUTORIAL 


| You'll Need 
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Lucy 
Hattersley 


Lucy is the editor 
of The MagPi 
magazine. She 
enjoys hacking and 
fixing technology, 
and building quirky 
projects. She's 
done the Samba all 
weekend long! 


magpi.cc 


Raspberry Pi 
microSD card 


Keyboard and 
mouse for setup 


Network and 
router (Ethernet 
recommended) 


Build a 


Samba file server 


Use Samba/CIFS to share a Raspberry Pi directory 


with other computers on a network 


file server where you can store backups and 
share files from all the other computers on 
your network. 
Samba is the Linux implementation of the SMB/ 
CIFS file-sharing standard used by Windows PCs 
and Apple computers, and widely supported by 


| t’s easy to use a Raspberry Pi as a Samba 


media streamers, games consoles, and mobile apps. 


With Samba activated, you can quickly copy files 
from a computer on your network to a Raspberry Pi 


using wireless LAN (or a direct Ethernet connection). 


This tutorial assumes that you’ll use a keyboard, 
mouse, and monitor to set up your file server; 
alternatively, you can enable SSH (magpi.cc/ssh) 
and connect to it remotely from another computer 
on your local network. 


The Samba configuration file is 
located at /etc/samba/smb.conf 
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We also assume you’re using a 32GB (or smaller) 
microSD card, which provides a reasonable amount 
of storage space without requiring any extra steps 
to make it accessible. However, if you need extra 
storage, it’s possible to mount a large external USB 
drive and create a Samba entry for it. 

Alternatively, if you want to keep things 
compact, you can install Raspbian on microSD 
cards of up to 256GB, although we think it’s 
wiser to install Samba on an external drive and 
use a smaller microSD to boot Raspbian and 
connect to it. 

We suggest checking non-working microSD 
cards online (magpi.cc/2q97aGO) before you buy, 
to make sure you get one that’s fully compatible 
with the Raspberry Pi. 


The [share] section in Samba's 
configuration file contains the details 
of a directory shared on the network 


Once set up, you can mount your home file 
server on all the other computers on your 
network, and use it as aconvenient place to store 
everything from music files you want to share 
with your housemates, to backups of important 
documents and save-game files you’d like to share 
between computers. 

We recommend using a wired Ethernet 
connection for stability and fast transfer speeds. 
The project will still work if you connect your 
Raspberry Pi via WiFi, although performance will be 
affected, particularly when it comes to copying over 
large files. 


Install Raspbian 

Download the latest version of NOOBS 
(or the latest Raspbian Stretch with Desktop 
image file) and install it to a microSD card. See 
magpi.cc/quickstart if you’re unsure on how to 
set up a Raspberry Pi for the first time. Insert the 
microSD card into your Raspberry Pi and connect 
the keyboard, mouse, and HDMI cable. We suggest 
you connect an Ethernet cable between your 
Raspberry Pi and modem/router (otherwise use the 
wireless LAN icon to connect to a wireless network 
when booted up). Attach the power cable to boot up 
your Raspberry Pi. 


Install Samba 

Samba is available in Raspbian’s standard 
software repositories. We’re going to update our 
repository index, make sure our operating system 


A Activate Samba support in 

Windows 10 and you'll be 
able to access the shared 
directory over a network 


is fully updated, and install Samba using APT. Open 
a Terminal and type: 


sudo apt update 
sudo apt upgrade 
sudo apt install samba samba-common-bin 


Answer Y when prompted. 


Create shared directory 
Now we’re going to create a dedicated 
shared directory in our home directory. 


sudo mkdir /home/pi/shared 


You can put it anywhere, but ours is in the home 
directory (it makes it easier to access without 
adjusting permissions). You’ll be able to access this 


—_ WEE 
Windows Securtty 


Enter network credentials 


Enter your credentials to connect toc RASPBERRY 


UI Remember my credentials 


Access ts denied. 


TUTORIAL EEE 


TopTip è 


Status report 


You can see the 
status of the 
Samba drive using 
sudo service 
smdb status. 
And you can use 
smbd restart to 
turn the service 
off and on again. 


Enter the credentials 
(username and 
password) created 
during the setup 
process to access 
the Samba share 
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> Use testparm to test 
the edits you make 
to smb.conf 


YV File Explorer 
displaying the Samba 
share in its Network 


-e*e P Gia „m 


so Eile craspoenyp: - 


directory from other computers on your network. 
Files you drop in here are accessible on other 
computers, and files you drop into the directory 
from other computers will appear on Raspberry Pi. 


Configure Samba 

Now we need to edit Samba’s configuration 
file to make the shared directory visible to other 
computers on the network. First, let’s make a 
backup just in case you want to look at the original. 


sudo cp /etc/samba/smb.conf /etc/samba/ 
smb.conf_backup 


Now let’s edit the Samba configuration file. Enter: 


sudo nano /etc/samba/smb.conf 


The smb.conf file is packed with detailed 
information on the Samba configuration (it’s a 
good idea to read through it all). Scrollto the end 
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aspberrypi: ~ 


of the file and add the configuration code from the 
smb-pi.conf listing. Press CTRL+O to save the file, 
and CTRL+X to exit nano. 


Looking at the configuration file 

The Samba configuration file uses the 
same format as Windows .ini files, with sections 
surrounded with square brackets. The commands 
are case-insensitive and ignore white space. Let’s 
take a closer look at some of the lines in the file... 


The location of the shared folder: 


path = /home/pi/shared 


Set this to ‘no’ to turn off the service: 


available = yes 


This is the list of users allowed to log in to 
the service: 


valid users = pi 


Whether this share is seen in the list of available 
shares in a net view and in the browse list: 


browsable = yes 


Ensures that users can write to files (the default 
is no): 


writable = yes 


Take a look at the Samba.org documentation for 
more information on all the configuration options 


available in smb.conf (magpi.cc/alEJZY). Test out 
the Samba configuration file with testparm. Enter 
the following: 


testparm 


...and you should see a series of ‘Processing 
section’ tests. At the end it should say ‘Loaded 
services file OK’. If not, head back to the start of 
this step and check you have entered the additional 
setup text correctly. 


Create a password 
Before we start the server, you’ll want to set 
a Samba password. Enter: 


sudo smbpasswd -a pi 
Enter a simple and memorable password for 
testing (you can create a more secure one later by 
rerunning the command at any time). 
Now restart your Samba server: 


sudo service smbd restart 


The Samba service will restart and the shared drive 
will now be available on the network. 


07 Turn on SMB in Windows 
Samba used to be installed by default 
in Windows, but it has recently become an 
optional installation. 

In Windows 10, click on the Search bar and type 
‘Control Panel’. Click on Control Panel in the 
search results. Now click ‘Programs’ and ‘Turn 
Windows features on or off’. Scroll down to find 
‘SMB 1.0/CIFS File Sharing Support’ and click the 
‘+ expand icon to reveal its options. Place a check 
in the box marked ‘SMB 1.0/CIFS Client’. Click 
OK. This will enable Samba client support on your 
Windows 10 PC so it can access your Raspberry Pi. 


Find your Pi on the network 
You’ll now be able to find your Raspberry Pi 
file server (named RASPBERRYPI by default) from 
any device on your local network. 
Click on the File Explorer icon in Windows and 
choose the Network option in the sidebar. You will 


BEX at“. 


zo 19% complete 


Copying 1 item trom ma 


19% complete 


A A file being copied from 
the Windows PC computer 
to the shared directory on 
Raspberry Pi 


smb-pi.conf 


> Language: ASCII 


01. [share] 


002. path = /home/pi/shared 
003. available = yes 

004. valid users = pi 

005. read only = no 

006. browsable = yes 

007. public = yes 
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DOWNLOAD 
THE FULL CODE: 


© magpi.cc/ryrLvF 


see RASPBERRYPI in the list of devices. Click it 
and the ‘Enter network credentials’ window will 
appear. Enter your username pi and the password 
you created in Step 6. Click ‘Remember my 
credentials’ if you want to save the password, and 
then click OK. 

The File Explorer will now display the shared 
directory. You can drag files and folders from 
Windows to the shared folder and they will be 
copied to your Raspberry Pi. 


Find the Pi on a Mac 

Samba works across many different devices. 
And it’s perfectly possible to access the shared 
folder from a Mac computer, or even an iOS or 
Android device (with the right app). Open a new 
Finder window on a Mac and choose Network in 
the sidebar. Click on ‘raspberryp? and ‘shared’ 
to access the directory. As with Windows, you can 
drag files directly to and from Raspberry Pi. E 


TopTip & 


Reboot 
everything 


If you've set 

it all up and 
have checked 
everything, try 
restarting your 
Raspberry Pi 
and Windows 
computer. 
Sometimes this 
helps Windows 
find the drive on 
the network (once 
the shared drive 
appears, we find 
it stable). 
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Use SSH (Secure Shell) 
with Raspberry P1 


Remotely control your Raspberry Pi from a PC, Linux, or Mac 
computer and transfer files using SSH. By Lucy Hattersley 


Lucy 
Hattersley 


Lucy is the editor 
of The MagPi. 

She likes retro 
gaming, building 
robots, coding, and 
making magazines 
and websites. 


magpi.cc 


| You'll Need 


> Raspberry Pi 
> Network router 
> Raspbian OS 


> Second computer 
(Windows, macOS, 
or Linux) 


encrypted networking technology that 
enables you to manage computers from 
the command line over a network. 

SSH is handy if you want to quickly connect to a 
Raspberry Pi from a terminal window on another 
computer. It’s also ideal for lightweight distro 
installations that don’t have graphical interfaces, 
and projects that don’t have a screen (such as 
robots). It’s especially useful when creating 
Internet of Things (IoT) projects, as these may be 
embedded inside other hardware. 

We covered VNC (Virtual Network Computing) 
on page 19 - and in more detail in issue 71 of The 
MagPi, magpi.cc/71 - and Secure Shell offers a 
similar service. But while VNC shares the entire 
desktop, SSH works from the command line. 


S SH (also known as ‘Secure Shell’) is an 


Bi pi@raspberrypi: - 


Filename 
< 
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Local site: C:\Users\lucyh\Desktop\ 


2 files. Total size: 39,254,781 bytes 


Server/Loc... D. Remote file Size Pr... Status 
Queued files Failed transfers Successful transfers 


SSH also enables you to share files to, and 
from, a Raspberry Pi using SCP (secure copy) 
on the command line, or SFTP (SSH File 
Transfer Protocol). 

You don’t need to install any software to start 
using Secure Shell. Linux, macOS, and Windows 10 
have the SSH command-line application installed 
by default. 

You’ ll need to use the password for your 
Raspberry Pi to log in. For security reasons, 
we strongly recommend changing the default 
password (magpi.cc/tZdxha). 

SSH uses an encrypted network, so it doesn’t 
send your password as plain text. More advanced 
users can control the encryption keys, using 
ssh-keygen. For now, we’ll look at setting up and 
using Secure Shell. 


FASA 


Password: Port: Quickconnect 


D 


kssful 
P/pi/Documents* 
nts 

v 

ments” successful 


Remote site: /home/pi 


zm Desktop A J pi A 
$ Downloads v ? cache v 


File.. ° Filename Fil.. File.. Last... I 
> < > 


7 files and 17 directories. Total size: 10,108 bytes 


QAO Queue: empty 


A’ SSH is turned off by default in Raspbian and has to 
be enabled. The easiest way is to use Raspberry Pi 
Configuration Tool 


Activate SSH in Raspbian 

For security reasons, Secure Shell is 
not turned on by default in Raspbian. On your 
Raspberry Pi, choose Menu > Preferences > 
Raspberry Pi Configuration. Click on Interfaces and 
set SSH to Enabled. Click OK. You don’t need to 
restart your Raspberry Pi, and SSH will be enabled 
whenever you use that installation of Raspbian 
from that point on (be sure to have updated your 
password from the default, which is ‘raspberry’). 


Activate SSH Client in Windows 

Linux and macOS both support SSH out-of- 
the-box; skip ahead to Step 3 if you are using one 
of those operating systems. 

Windows 10 supports SSH, but you need to 
activate it. Click on Search and look for ‘Manage 
Optional Features’. Click it in Search to open the 
Settings window. 

Click ‘Add a feature’ and wait for the list of 
Optional Features to load. Scroll down the list to 
Open SSH Client (Beta). Click Install. 


Get your IP address 

Connect your Raspberry Pi to a local network. 
Use wireless LAN, or connect Raspberry Pi directly 
to arouter with an Ethernet cable. Open a Terminal 
window and enter the following command: 


hostname 
You should see: 

raspberrypi 
In some circumstances you can use this host name, 
which is handy if you don’t have the IP address, but 


it’s more reliable to use the IP (internet protocol) 
address. Enter this to get your IP address: 


hostname -I 


This will return four numbers separated by dots. 
For instance, ours is: 


192.168.0.41 


Write this number down. You’ll need it shortly. 


Connect via SSH 

Open Command Prompt on a Windows PC, 
or a Terminal window in Linux or macOS. 
Enter this command: 


ssh pi@<IP> 


Replace <IP> with the IP address of your Raspberry 
Pi. In our case, we enter ssh pi@192.168.0.41. 

The first time you do this, you’ ll get a message 
saying that the authenticity can’t be established, 
followed by a long cryptographic hash of letters 
and numbers. It will say, ‘Are you sure you want to 
continue connecting? 

Enter yes and press RETURN. You’ll be asked to 
enter the password for your Raspberry Pi. 
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On Raspberry Pi 

You will now see your usual command line 
replaced with pi@raspberrypi: -$. You are now 
logged in and working on the command line from 
your Raspberry Pi. Enter 1s and you’ll see Desktop, 
Downloads, Documents, and the other unique 
Raspberry Pi folders and files. You can create, edit, 
move, and work with files as if you were using 
Terminal on your Raspberry Pi. 


TopTip è 


SSH from boot 


You can activate 
SSH when setting 
up Raspbian 

by placing a 

file named ssh, 
without any 
extension, onto 
the boot partition 
of the microSD 
card from another 
computer. When 
Raspberry Pi 
boots, it looks for 
the ssh file. If it 

is found, SSH is 
enabled and the 
file is deleted. The 
content of the file 
does not matter; it 
could contain text, 
or nothing at all. 


Use the hostname 
command in 
Terminal to confirm 
the host name 
‘raspberrypi’, 

and add the -I 

flag to get your 
assigned IP (internet 
protocol) address 


Get Started With Raspberry Pi & | 93 


Ms TUTORIAL 


TopTip è 


Turn SSH on 
and off 


You can activate 
and start 

SSH from the 
command line on 
your Raspberry Pi: 


sudo systemctl 
enable ssh 
sudo systemctl 
start ssh 


And turn it off 
using: 


sudo systemctl 
stop ssh 

sudo systemctl 
disable ssh 


Visual interfaces 

There are limitations to SSH. A plain 
SSH connection can’t open programs that use a 
graphical interface, so you should learn to use 
command-line alternatives (such as nano or vim 
instead of Leafpad for text editing). See How to Edit 
Text files on Raspberry Pi (magpi.cc/BNFKeP). 

On Linux computers, you can forward your X 

session over SSH, to allow the use of graphical 
applications, by using the -Y flag: 


ssh -Y pi@<IP> 


Now you are on the command line as before, but 
you have the ability to open up graphical windows. 
For example, typing: 


scratch & 


...will open up Scratch in a graphical window. 
Note that X11 is no longer present on Macs 

with macOS (magpi.cc/AqEvnA), so you have to 

download and install it (xquartz.org) separately to 

access graphical windows over SSH. 


WW Aen EL ZC KKK $ 


A Use SFTP (Secure File Transfer Protocol) in a program 
such as FileZilla to transfer files to and from your 
Raspberry Pi via a graphical interface 


scp Downloads\MagPi85.pdf pi@192.168.0.41:/ 
home/pi/MagPi 


This copies The MagPi issue 85 PDF from the 
Downloads folder on our Windows PC to the MagPi 
directory on Raspberry Pi. 

Notice that the directory path uses backslash (‘\’) 
for Windows source and slash (‘/’) for the Linux 
destination (if you’re using a Mac or Linux machine, 
it'll be a slash in both source and destination.) 


07 Copy files 
It’s not easy to share files using Secure 
Shell from the command line, but it’s possible 
and a handy skill to learn. If you’re still accessing 
Raspberry Pi, enter exit at the command line to 
return to your local shell: 


exit 


With SSH turned on, you can copy files from 
your source computer to Raspberry Pi using 
SCP. We’ve downloaded The MagPi issue 85 
(magpi.cc/85) PDF file to our Downloads folder. 
We’re going to copy it to the MagPi directory on 
our Raspberry Pi. 

Use the scp command followed by the path to the 
source file, and then the destination location. 
The destination is pi@<IP> followed by a colon ‘:’ 
and the path to the destination location. 


scp <source> pi@<IP>:<destination> 


Replace the <source> and <destination> parts with 
the paths to the file and desired destination folder, 
and add your Raspberry Pi’s IP address. 

For instance, copying the PDF file on our 
machine looks like this: 
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Copying files 

If you copy a lot of files back and forth from 
a computer to Raspberry Pi, then it’s a good idea to 
set up SFTP using a dedicated FTP program, such as 
FileZilla (filezilla-project.org). 

Install FileZilla on your computer (it is available 
for Linux, Windows, and macOS). 

Open FileZilla and choose File > Site Manager. 

Now click New Site and you can give the site a 
custom name, such as ‘Raspberry Pi’. 

Change the Protocol to ‘SFTP - SSH File 
Transfer Protocol’. 

Enter ‘raspberrypi’ in the Host field, ‘pi’ in the 
User field, and your Raspberry Pi password in the 
Password field. 

Click Connect and you will connect remotely to 
the Raspberry Pi. You will see all your Raspberry Pi 
files in the right-hand ‘Remote’ side of the display. 
On the left, in the ‘Local Site’ section will be all 
the files on your computer. Double-click directory 
folders in either side to navigate into them, and 
use the ‘..’ folders at the top of each list to navigate 
back up to the parent folder. 

Double-click a file in Local Site to send 
it to the Remote section, and vice versa. 

Follow the FileZilla tutorial if you need more 
guidance (magpi.cc/WovBgn). 7 


The only guide you 
need to get started 
with Raspberry Pi 
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How to use your new Computer 


N : e Learn how to set up the Raspberry Pi, 
] N N install an operating system, and start using it 
V N À e Follow step-by-step guides to code your 
own animations and games, using both the 
Scratch and Python languages 


e Create amazing projects by connecting 
electronic components to the Pi’s GPIO pins 
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raspberrypi 


»/Documents 
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-FW-r--r-- 
drwxr-xr-x 
drwxr-xr-x 
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pi@raspberrypi: 
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-lah /home/pi/Documents/ 


„OK 
„OK 


0 


„OK 
.OK 
„OK 


Dec 
Dec 
Dec 
Nov 
Nov 
Nov 


15 
15 
1,9 
25 
25 
25 


14: 
12: 
14: 
17 
17: 
17 


37 
52 
37 


:49 


49 


:46 


a _ file.txt 
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directory owner group other 


Expand Filesystem 
Change Password... 
| raspberrypi 


© To Desktop © |To CLI 


Login as user pi 
© Wait for network 


You can set ` © Enabled ©) Disabled 

Raspbian to boot 
into the command © Enabled © Disabled 
line (instead of the 
graphical interface) 
from the Raspberry Pi 
Configuration settings 


a =all including hidden files 
-h = human-readable (makes large file sizes 
mote readable) 


Options are case-sensitive. Sols -landls -Lare 
two different things (small ‘1’ is long listing format; 
large ‘L’ is dereference mode). Sometimes options are 
listed out in full. These start with two hyphens and 
have a single hyphen for spaces. This command is the 
same ag ls -lah: 


ls -1 --all --human-readable 


But it’s more common to see (and use) the single 
letter approach. 


Sudo 

Sudo stands for ‘substitute user do’, although it’s 
often also called ‘superuser do’. If you have multiple 
users on your system, it can be used to perform 
commands as another user. 

It’s mostly used to get root access to your Linux 
installation. There is an account that controls your 
pi user, called ‘root’. This is an all-powerful account, 
which can change just about anything on your system. 

Your default account can view files in the root of 
the hard drive, but it can’t create or delete files at 
the root. Enter: 


cd / 
touch test.txt 


You’ll see touch: cannot touch ‘test.txt’: Permission 
denied. However, enter: 


sudo touch test.txt 
...and the test.txt file will be created on the root of 
your hard drive. You can see it usingls -1. 

Now try to delete it: 

rm test.txt 
It will say rm: remove write-protected regular empty 
file ‘test.txt’?” Enter Y and it’ll say rm: cannot 
remove ‘test.txt’: Permission denied. 
You need to use sudo to remove the file: 


sudo rm test.txt 


You can see why sudo is such a powerful tool. Without 
it, you couldn’t install software using apt or apt-get. 


But with it, you can remove or delete vital system 
files. Enter 1s /bin and you’ll see many programs 
(known as ‘binaries’) used by Linux. These include 
the 1s command you just used. Accidentally deleting 
these files could make your system unstable. 

So use sudo with care. In Raspbian you don’t need to 
enter the password to use sudo. On many other Linux 
systems, however, you will be asked for the password 
before you can use sudo. 


What's up, man? 

There are lots of ways of getting help inside the 
command line. The first command you should turn 
to is man. This stands for ‘manual’ and gives you 
instructions on Linux commands and tools. Enter: 


man Le 


...and you’ll see the manual for the list command. 
Notice under the SYNOPSIS it says: 


ls [OPTION]... [FILE]... 


This shows you the structure of the command. 
Almost all commands are in the ‘command, option, 
argument’ structure, although some arguments have 
more than one [FILE] argument (such as copy, which 
requires a source and destination file). 

Press the space bar to move down the instructions. 
Here you will see a list of all the available options. 
With man, you can get detailed information on just 
about every tool on the command line. You can even 
get a manual for the man command with: 


man man 


If you need a quick reminder on how to use a 
command, try using it with -h or --help as an option: 


touch --help 


...tells you what options are available with the touch 
command. You can use this with many command-line 
tools to get a quick refresher on how they work. 

Moving from a GUI to a command line is a vital skill for 
hackers and coders. Everything on your computer, from 
programs to preferences, is stored in the file system 
somewhere. Learning to use the command line makes 
you a more capable Raspberry Pi user. 

So, the next time you make a file, move a file, or 
delete something, don’t head to the File Manager. 
Open Terminal and perform tasks from the 
command line. Soon it’ll be second nature. 


WO FEATURE 


| Raspberry Pi 


Gone too long, the A+ is back with the 
power of Raspberry Pi 3 behind it 


new A-form-factor design, more compact 

and lightweight than the full-size B and B+ 
ranges, it was Raspberry Pi A+, released four years 
ago. Since then, the family has grown considerably: 
we’ve seen Raspberry Pi 2, 3, Zero, Zero W and WH, 
3B+ and, most recently, Raspberry Pi 4. 


T he last time the Raspberry Pi family had a 


m Packs the power of Raspberry Pi 
3B+ into the same footprint as 
the original Raspberry Pi A+ m 


Launched in November 2018, Raspberry Pi 3A+ 
packs the power of Raspberry Pi 3B+ into the same 
footprint as the original Raspberry Pi A+. Read on 
for the lowdown on what Eben Upton describes as 
“the best product we can make.” 


UK suppliers: 


Gizem PIMORONI 
The Pi Hut Pimoroni 
magpi.cc/zVTpyC magpi.cc/LhuKdS 
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For a complete list of 
resellers globally where the 
new Raspberry Pi 3 Model 


CPC RS Components A+ can be purchased, 
please see 
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Meet Raspberry Pi 3A+ 


This mini marvel squeezes a lot into its compact footprint 


SoC: 
Broadcom 
BCM2837Bo 
quad-core A54 
(ARMVv8) 64-bit 
@ 1.4GHz 


Y Full-size display (DSI) and 
camera (CSI) ports make 
connecting peripherals a snap 


GPU: 
Broadcom 
VideoCore IV 


NETWORKING: 


2.4GHz and 5GHz A The radio, originally developed 
802.11b/g/n/ac for 3B+, makes Raspberry Pi 
wireless LAN 3A+ the first A-model to feature 
on-board networking 


RAM: 
512MB LPDDR2 
SDRAM 


BLUETOOTH: 
Bluetooth 4.2, 
Bluetooth Low 
Energy (BLE) 


d Raspberry Pi 3A+ benefits 
from the same clever 
power management chip 
(PMIC) as 3B+ 


GPIO: 
40-pin GPIO 
header, 
populated 


STORAGE: 
microSD 


rors: QuickStart guide 


HDMI, 3.5mm 
analogue audio- 
video jack, 


1x USB 2.0, Raspberry Pi 3A+ is directly compatible with 3B+ 
Camera Serial 


$ H 
Interface (CSD, and all other Raspberry pi models. If you ve already 
Display Serial got a power supply and microSD card with a new l l 
Interface (DSI) version of Raspbian installed, you’re ready to go. A Unlike the Zero family, 
. ` s Raspberry Pi 3A+ includes 

If 3A+ is your first Raspberry Pi, check out pages both full-size HDMI and 

6-1 r ur onlin ick r idet analogue audio-video outputs 
DIMENSIONS: 3,0 see ouro e QuickStart guide to get up 

and running fast. 


67x56x11.5 mm 
: magpi.cc/quickstart 
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FEATURE EEE 


< Raspberry 3A+ has the 
same 1.4GHz system-on- 
chip (SoC) as 3B+, with no 
loss of performance 


> The biggest change from 
Raspberry Pi 3B+: the 
reduction from four to one 
USB 2.0 ports 
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Benchmarking 


Raspberry Pi 3A+ 


or projects where a full- 
> size Raspberry Pi is simply 
too bulky, there hasn’t 
been much choice: aside from 
the Compute Module 3, which 
is targeted at industrial users, 
the choices were the four-year- 
old Pi A+ or ultra-compact Pi 
Zero family - and in either 
case it meant a dramatic drop 
in performance. 
Raspberry Pi 3A+ comes 
with the promise of full- 
size performance in a small, 


lightweight, and less power- 
hungry package, but the only 
way to see if that is true or not 
is to put it through its paces ina 
range of benchmarks. 


Spec comparison 

At its heart, Raspberry Pi 3A+ is 

a cut-down version of 3B+. It has 
the same Broadcom BCM2837Bo 
system-on-chip (SoC) roughly in 
the centre of the board, hidden 
under a metal heat-spreader, 


Small but mighty, the reduction 
in size doesnt mean Raspberry 
Pi 3A+ loses any performance 
compared to 3B+ 


which runs at the same 1.4GHz 
frequency. While 512MB of RAM 
is less than the 1GB of a 3B+, the 
smaller Raspberry Pi 3A+ can 
certainly hold its own. 

Looking back at the original 
Raspberry Pi A+, it’s hard to 
imagine they’re from the same 
family: from a single-core 
32-bit 700MHz processor and 
no networking to a quad-core 
64-bit 1.4GHz processor with 
built-in wireless LAN and 
Bluetooth. What an upgrade! 


Python GPIO 


Higher is better O 
Designed to highlight a real- 
world bottleneck, the Python 
GPIO benchmark switches a 
single pin on and off while a 
frequency counter measures 
how quickly the pin is toggled. 
The faster the processor, the 
faster the pin can be toggled 
before the processor hits its limit. 


SysBench CPU 


Lower is better 


Focusing on the central processor's 
performance, the SysBench CPU 
benchmark tests how quickly a 
Raspberry Pi can perform prime 
number calculations. For Raspberry 
Pi models with quad-core 
processors, the test is run twice: 
once with a single thread using only 
one of the cores, and again with 


J FREQUENCY (kHz) 


62.32 


58.55 
43.07 42.63 48.75 42.62 
Model A Model B Zero ZeroW ` Model A Model B+ Pi 2 Pi3 Pi 3B+ Pi 3A+ 
343.06 er J SINGLE-THREADED (SECS) 
336.91 337.02 
FÜ] MuLTI-THREADED (SECS) 
218.53 
139.22 
119.22 119.23 
2 EN 
Model A Model B Zero ZeroW ` Model A+ Model B+ Pi3 Pi 3B+ Pi 3A+ 


four threads using all four cores. 
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SysBench 
Memory Throughput 
Higher is better 


Processor performance is only 

part of the puzzle regarding 

overall system performance: in the 
SysBench Memory Throughput test, 
measurements show how quickly 

a Raspberry Pi can read and write 
to the random-access memory 
(RAM) in 1kB chunks, reported in 
megabytes per second (MBps). 


Power Draw 
Lower is better 


More performance typically means 
more power used. Here, each 
Raspberry Pi is connected to an HDMI 
display, wireless keyboard, and, where 
applicable, a WiFi or wired Ethernet 
network before two measurements 
are taken: power used while Raspberry 
Pi is sat idle at the desktop, and again 


while running a CPU-heavy application. 


© 


Thermal 
Performance 
Cooler is better 


I 
I 
| 
I 

Raspberry Pi 3B+ benefited l 

from a change to the way i 

the system-on-chip (SoC) is I 

attached to the circuit board, l 

allowing it to better dissipate i 

heat. With Raspberry Pi 3A+ l 

having a smaller board, i 

this test captures thermal I 

images under heavy CPU l 

load to show how well the i 
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two designs cope. 
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Size & Weight 
Lower is better 
The biggest difference between Raspberry 
Pi 3B+ and 3A+ is their respective sizes. Here, 
the footprint of each model is measured 
from its widest points - to include the size of 
the ports which sit proud of the board - and 
its weight measured, both important aspects 
for embedded and robotics applications. 
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WO FEATURE 


Eben Upton and 
Roger Thornton on 2 
RaspberryPi3A+ "WE 


we’re dealing with a bunch of subsystems,” Eben 
Upton, co-founder of the Raspberry Pi Foundation, 
explains of the development process that has 


Eben and Roger talk about Raspberry Pi 3 Ais delivered Raspberry Pi 3 Model A+. “Some subset 


. . . on of the trains will arrive at the station, and when 

inspiration and launch timing enough of them arrive then we’ve got anew 
product we can make. We don’t have a big team of 

a a ` marketing guys who make PowerPoints about our 
roadmap. It’s much more coffee-table-oriented 


! Simplifying certification | than that.” 
Bringing back A+ 


“The A+ form factor was always a good form 

factor,” says Roger Thornton, Principal Hardware 

Engineer. “A lot of people have asked us for an A+ 

again, and we were able to make that, so we did.” 
With both Raspberry Pi 2 and 3 having 

launched exclusively in larger B-variant form 


“What's the cost to do a certification 
campaign,” Eben asks. “Couple of 
hundred thousand?” 

“For a five-gig one, yeah, it's about 
250... 300 000,” answers Roger - the cost 
of clearing a radio-containing product 


like the Raspberry Pi 3 for general sale. V As with any Raspberry Pi, factors, the A+ has been absent from the line-up 
Raspberry Pi 3B+ moved to a modular 3A+ undergoes in-depth for a full two generations. “It was skipped for 
testing before it's released ` Ge 
radio certification, so the existing to the public Raspberry Pi 2 because it simply wasn’t around 
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compliance work remains largely valid 
for 3A+. “A lot of the work we'd done to 
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modularise the board meant that we 
could copy over pretty much all of our 
compliance work,” Roger explains, “so 
thankfully this product's been just a bit 
of paperwork. There's definitely been an 
improvement in time-to-market.” 
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for long enough,” recalls Eben. “It normally takes 
six to nine months for us to get our feet under 
ourselves, and by that time it was very clear that 
the 3B was imminent.” 

“The Zero W happened the year after the 3B,” 
Roger adds, “and to some extent addressed the gap 
that an A+ might have occupied.” 

The Zero family isn’t a complete replacement for 
the A+, though, as the launch of Raspberry Pi 3B+ 
hammered home. 


Miniature size, 
full performance 


“We're confident that the performance you saw 
on a 3B+ you'll be able to get on a 3A+," says 
Roger. “There's no reduction because of the 
board size change; you should still be able to 
run the processor at the same speed. We have 
had to reduce the memory to hit the price point 
we're after, but it still runs nicely." 

“When we launched the original A+, we 
launched it with half the RAM of the original B+,” 
Eben adds. “At the time that meant 256MB; now 
halving the RAM still leaves you with half a gig, 
which is kind of fun.” 


FEATURE HER 


d “if we have an 
opportunity to bring 
our best tech down 
a bit, then we do," 
explains Eben Upton 


K “A lot of people have 
asked us for an A+ 
again, and we were 
able to make that,” 
© says Roger Thornton 


of the launch 


Filling a hole 
“There’s a massive performance gulf between the 
3B+ and Zero,” explains Eben. “3A+ represents us 
bringing our best technology to the lowest possible 
price point. We can’t bring this technology down 
to the Zero price point, at the moment, but we can 
bring it down a bit. 

“We don’t just like to sit there at $35 feeling 
pleased with ourselves. If we have an opportunity 
to bring our best tech down a bit, then we do. I 


m This is us bringing our best 
technology to the lowest 
possible price point © 


mean, this is the best product we can make. We 
don’t know how to make anything better at the 
moment. It’s lovely, actually. We like to make 
physically beautiful objects. They sometimes cost a 
bit of money to make, or cost a bit of blood, I think, 
and this... I mean, for me, once we knew we could 
make it, I think we kind of had to. 

“There may be another motivation for doing 
it: it?s kind of tidying up ‘classic’ Raspberry Pi,” 
Eben admits. With their attention turning to 
Raspberry Pi 4 - since launched in June 2019 - the 
hardware design team were starting the research 
phase of figuring out what they might do next. 
“Tying up loose ends is an important part of that, 
and the lack of an A+ form-factor product is a 
loose end,” says Eben. M 
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Raspberry Pi Regulatory compliance and safety 
information 

Product name: Raspberry Pi 3 Model A+/B+ 
IMPORTANT: PLEASE RETAIN THIS 
INFORMATION FOR FUTURE REFERENCE. 


Warnings 

+ Any external power supply used with the 
Raspberry Pi shall comply with relevant 
regulations and standards applicable in the 
country of intended use. The power supply 
should provide 5V DC and a minimum rated 
current of 2.5A. 


Instructions for safe use 
This product should not be overclocked. 
Do not expose this product to water or 
moisture, and do not place it on a conductive 
surface whilst in operation. 
Do not expose this product to heat from any 
source; it is designed for reliable operation at 
normal room temperatures. 
Operate this product in a well-ventilated 
environment, and do not cover it during use. 
Place this product on a stable, flat, non- 
conductive surface while in use, and do not 
let it contact conductive items. 
Take care while handling this product to 
avoid mechanical or electrical damage to the 
printed circuit board and connectors. 
Avoid handling this product while it is 
powered. Only handle by the edges to 
minimize the risk of electrostatic discharge 
damage. 
Any peripheral or equipment used with the 
Raspberry Pi should comply with relevant 
standards for the country of use and be 
marked accordingly to ensure that safety and 
performance requirements are met. Such 
equipment includes, but is not limited to, 
keyboards, monitors, and mice. 


For all compliance certificates and numbers, 
please visit www.raspberrypi.org/compliance. 
mia 
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Čeština 


Raspberry Pi 3 Model A+/ B+ 
DULEZITE: TUTO INFORMACI SI PONECHTE 
PRO POUŽITÍ V BUDOUCNU. 


Varování 
Každý externí napájecí zdroj použitý s 
Raspberry Pi musí splňovat příslušné 
předpisy a normy platné v zemi určení. 
Napájecí zdroj by měl poskytovat 
stejnosměrné napětí 5V a minimální 
jmenovitý proud 2,5A. 

Pokyny pro bezpečné používání 

+ Tento výrobek by neměl byt přetaktován. 
Výrobek nevystavujte vodě ani vlhkosti a za 
provozu ho neumistujte na vodivý povrch. 
Výrobek nevystavujte teplu z jakéhokoli 
zdroje; je navržen pro spolehlivý provoz při 
normálních pokojových teplotách. 

Výrobek používejte v dobře větraném 
prostředí a za provozu ho nepřikrývejte. 
Výrobek při používání ponechte na stabilním, 
plochém a nevodivém povrchu a zabrarite 
jeho dotyku s vodivými předměty. 

Při manipulaci s výrobkem dbejte na to, 
abyste zabránili mechanickému nebo 
elektrickému poškození desky plošných 
spojů a konektorů. 

Vyvarujte se manipulace s výrobkem, když 

je napájen. K manipulaci používejte pouze 
okraje, abyste minimalizovali riziko poškození 
elektrostatickým výbojem. 

Veškerá periferní a další zařízení používaná 
s Raspberry Pi by měla být v souladu s 
příslušnými normami země použití a měla 
by být odpovídajícím způsobem označena, 
aby se zajistilo, že splňují požadavky na 
bezpečnost a výkon. 

Všechna osvědčení o shodě a čísla najdete na 

www.raspberrypi.org/compliance. 


Dansk 


Raspberry Pi 3 Model A+/ B+ 
VIGTIGT: OPBEVAR DENNE INFORMATION FOR 
FREMTIDIG REFERENCE. 


Advarsler 
Eksterne strømforsyninger, der anvendes til 
Raspberry Pi skal være i overensstemmelse 
med relevante bestemmelser og standarder, 


som er gældende i det land, hvor anvendelsen 
er tiltænkt. Strømforsyningen skal give 5 V 
jævnstrøm og en nominel strømstyrke på 
mindst 2,5 A. 
Instruktioner for sikker brug 
Dette produkt må ikke overophedes. 
Udseet ikke dette produkt for vand eller fugt, 
og sæt det ikke pa en ledende overflade 
under drift. 
Udseet ikke dette produkt for varme fra nogen 
kilder; det er designet til palidelig drift ved 
normal stuetemperatur. 
Anvend dette produkt i et godt ventileret miljø, 
og tildaek det ikke under brug. 
Anbring dette produkt pa en stabil, flad og 
ikke-ledende overflade under brug, og lad 
det ikke komme i berøring med ledende 
genstande. 
Veer forsigtig ved handtering af dette 
produkt for at undgä mekanisk eller elektrisk 
beskadigelse af printkort og stik. 
Undga handtering af dette produkt, mens det 
er tændt. Ma kun håndteres ved at holde i 
kanterne for at minimere risikoen for skader 
ved elektrostatisk udladning. 
Alt perifert udstyr eller udstyr, der anvendes 
til Raspberry Pi skal overholde relevante 
standarder i landet for anvendelse og 
meerkes i overensstemmelse hermed for at 
sikre, at kravene for sikkerhed og ydeevne 
er opfyldt. 
For alle overensstemmelsescertifikater og 
numre, ga pa www.raspberrypi.org/compliance. 


Nederlands 


Raspberry Pi 3 Model A+/ B+ 
BELANGRIJK: BEWAAR DEZE INFORMATIE 
VOOR TOEKOMSTIGE VERWIJZING. 


Waarschuwingen 
+ Elke externe voeding die met de Raspberry 
Pi wordt gebruikt, moet voldoen aan de 
relevante voorschriften en normen die van 
toepassing zijn in het land van het beoogde 
gebruik. De voeding moet 5V DC en een 
minimale nominale stroom van 2,5A leveren. 
Instructies voor veilig gebruik 
Dit product mag niet overklokt worden. 
Stel dit product niet bloot aan water of vocht 
en plaats het tijdens gebruik niet op een 
geleidend oppervlak. 
Stel dit product niet bloot aan warmte 
van welke bron dan ook; het is ontworpen 
voor betrouwbare werking bij normale 
kamertemperatuur. 
Gebruik dit product in een goed geventileerde 
omgeving en dek het niet af tijdens gebruik. 
Plaats dit product tijdens het gebruik op een 
stabiel, plat, niet-geleidend oppervlak en laat 
het niet in contact komen met geleidende 
items. 
Wees voorzichtig met het gebruik van dit 
product om mechanische of elektrische 
schade aan de printplaat en connectoren te 
voorkomen. 
Gebruik dit product niet terwijl het wordt 
gevoed. Alleen aan de randen vasthouden om 
het risico op schade door elektrostatische 
ontlading te minimaliseren. 
Alle randapparatuur of apparatuur die met de 
Raspberry Pi wordt gebruikt, moet voldoen 
aan de relevante normen voor het land van 
gebruik en dienovereenkomstig worden 
gemarkeerd om ervoor te zorgen dat wordt 
voldaan aan de veiligheids- en prestatie-eisen. 
Ga naar www.raspberrypi.org/compliance. 


Suomi 


Raspberry Pi 3 Malli At/ B+ 

TÄRKEÄÄ: SÄILYTÄ NAMA TIEDOT 

MYÖHEMMÄN KÄYTÖN VARALTA. 

Varoituksia 
Kaikkien ulkoisen Raspberry Pi -laitteessa 
käytettyjen virtalähteiden on noudatettava 
käyttömaassa sovellettavia asiaankuuluvia 
asetuksia ja standardeja. Virtalähteen virran 
on oltava 5V DC minimin nimellisvirran 
ollessa 2,5A. 

Ohjeet turvallista käyttöä varten 

+ Tata tuotetta ei saa ylikuormittaa. 
Älä altista tätä tuotetta vedelle tai kosteudelle, 
äläkä aseta sitä johtavalle pinnalle sen 
ollessa toiminnassa. 
Älä altista tätä tuotetta mistään lähteestä 
aiheutuvalle kuumuudelle; se on suunniteltu 
luotettavaa toimintaa varten normaaleissa 
huonelämpötiloissa. 
Käytä tätä tuotetta hyvin ilmastoidussa 
lämpötilassa, äläkä peitä sitä käytön aikana. 
Aseta tämä tuote vakaalle, tasaiselle, ei- 
johtavalle pinnalle sen ollessa käytössä, äläkä 
anna sen koskettaa johtavia kohteita. 
Noudata varovaisuutta tätä tuotetta 
käsiteltäessä mekaanisen tai sähköisen 
vaurioitumisen estämiseksi painetulle 
piirilevylle ja liittimille. 
Vältä tämän tuotteen käsittelyä sen ollessa 
kytkettynä virtalähteeseen. Käsittele vain 
reunoista sähköstaattisen purkautumisen 
vaaran minimoimiseksi. 
Kaikkien Raspberry Pi -laitteiden 
kanssa käytettävien oheislaitteiden ja 
muiden laitteiden on oltava käyttömaan 
asianmukaisten standardien mukaisia, 
ja niiden on oltava merkittyjä sen 
varmistamiseksi, että turvallisuus ja 
suorituskykyvaatimukset täytetään. 

Lisätietojen saamiseksi kaikista 

vaatimustenmukaisuussertifikaateista 

vieraile verkkosivustolla www.raspberrypi.org/ 

compliance. 


Français 


Raspberry Pi 3 Modèle A+/ B+ 

IMPORTANT: VEUILLEZ CONSERVER CETTE 
INFORMATION POUR VOUS Y REPORTER 
ULTÉRIEUREMENT. 


Avertissements 
Toute alimentation électrique externe utilisée 
avec le Raspberry Pi doit être conforme aux 
réglementations et normes applicables dans 
le pays d'utilisation. L'alimentation électrique 
doit fournir 5 V CC et un courant nominal 
minimum de 2,5 A. 

Consignes pour une utilisation en toute sécurité 

+ Ce produit ne doit pas être utilisé à une 
vitesse supérieure à celle prévue pour son 
usage. 
N'exposez pas ce produit à l'eau ou à 
l'humidité et ne le placez pas sur une surface 
conductrice pendant le fonctionnement. 
N'exposez pas ce produit à la chaleur quelle 
qu'en soit la source; il est conçu pour un 
fonctionnement fiable à des températures 
ambiantes normales. 
Faites fonctionner ce produit dans un 
environnement bien ventilé et ne le couvrez 
pas pendant l'utilisation. 
Placez ce produit sur une surface stable, 
plane et non conductrice pendant son 
utilisation et ne le laissez pas en contact avec 
des éléments conducteurs. 


Faites attention lors de la manipulation de ce 
produit pour éviter tout dommage mécanique 
ou électrique au niveau de la carte de circuit 
imprimé et des connecteurs. 
Evitez de manipuler ce produit lorsqu'il est 
sous tension. Ne manipulez que par les bords 
afin de minimiser les risques de dommages 
dus aux décharges électrostatiques. 
Tout périphérique ou équipement utilisé 
avec le Raspberry Pi doit étre conforme aux 
normes applicables dans le pays d'utilisation 
et être marqué en conséquence pour garantir 
la sécurité et les performances. 
Pour tous les certificats et numéros de 
conformité, veuillez consulter www.raspberrypi. 
org/compliance 


Deutsch 


Raspberry Pi 3 Modell A+/ B+ 
WICHTIG: BITTE BEWAHREN SIE DIESE 
INFORMATIONEN FÜR ZUKÜNFTIGE REFERENZ. 


Achtung 
Jedes externe Netzteil, das mit dem 
Raspberry Pi verwendet wird, muss den 
einschlägigen Vorschriften und Normen 
entsprechen, die im Bestimmungsland 
gelten. Die Stromversorgung sollte 5 V 
Gleichstrom und einen minimalen Nennstrom 
von 2,5 A liefern. 

Anweisungen fiir die sichere Verwendung 

+ Dieses Produkt sollte nicht übertaktet 
werden. 
Setzen Sie dieses Produkt nicht Wasser 
oder Feuchtigkeit aus und stellen Sie es 
während des Betriebs nicht auf eine leitfähige 
Oberfläche. 
Setzen Sie dieses Produkt keiner 
Wärmequelle aus. Es ist für einen 
zuverlässigen Betrieb bei normalen 
Raumtemperaturen ausgelegt. 
Betreiben Sie dieses Produkt in einer gut 
belüfteten Umgebung und decken Sie es 
während des Gebrauchs nicht ab. 
Stellen Sie dieses Produkt während des 
Gebrauchs auf eine stabile, flache, nicht 
leitende Oberfläche und lassen Sie es nicht 
mit leitfähigen Gegenständen in Berührung 
kommen. 
Seien Sie vorsichtig beim Umgang mit 
diesem Produkt, um mechanische oder 
elektrische Schäden an der Leiterplatte und 
den Anschlüssen zu vermeiden. 
Vermeiden Sie die Handhabung dieses 
Produkts während der Stromversorgung. 
Produkt nur an den Rändern anfassen, 
um das Risiko von elektrostatischen 
Entladungsschäden zu minimieren. 
Alle Peripheriegeräte oder Geräte, die mit 
dem Raspberry Pi verwendet werden, 
müssen den geltenden Normen für 
das jeweilige Land entsprechen und 
entsprechend gekennzeichnet sein, um zu 
gewährleisten, dass die Sicherheits- und 
Leistungsanforderungen erfüllt werden. 

Alle Konformitatszertifikate und -nummern 

finden Sie auf www.raspberrypi.org/compliance. 
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Raspberry Pi 3 Model A+/ B+ 
IMPORTANTE: CONSERVARE QUESTE 
INFORMAZIONI PER RIFERIMENTO FUTURO. 


Awisi 
Tutti gli alimentatori esterni utilizzati con 
il Raspberry Pi devono essere conformi 


alle normative e agli standard pertinenti 

applicabili nel paese di utilizzo previsto. 

Lalimentatore utilizzato dovrà fornire 5 V CC e 

una corrente nominale minima di 2,5 A. 
Istruzioni per l'utilizzo in sicurezza 

Questo prodotto non deve essere 

overcloccato. 

Non esporre questo prodotto all'acqua o 

all'umidità e non collocarlo su una superficie 

conduttiva mentre è in funzione. 

Non esporre questo prodotto a fonti di calore. 

Il prodotto è progettato per un funzionamento 

affidabile solo alla normale temperatura 

ambiente. 

Utilizzare questo prodotto in un ambiente ben 

ventilato e non coprirlo durante l'uso. 

Per l'uso, collocare questo prodotto su una 

superficie stabile, piana e non conduttiva. 

Evitare che venga in contatto con oggetti 

conduttivi. 

Durante l'uso o lo spostamento del prodotto 

prestare attenzione ad evitare danni 

meccanici o elettrici al circuito stampato e 

ai connettori. 

Evitare di maneggiare questo prodotto 

mentre é alimentato. Afferrare solo dai bordi 

per ridurre al minimo il rischio di danni da 

scariche elettrostatiche. 

Tutte le periferiche e le apparecchiature 

utilizzate con il Raspberry Pi devono essere 

conformi agli standard pertinenti per il 

paese di utilizzo ed essere dotate del relativo 

marchio a garanzia della conformita con i 

requisiti di sicurezza e prestazioni necessari. 
Per informazioni su numeri e certificati di 
conformita, visitare www.raspberrypi.org/ 
compliance. 
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Polski 


Raspberry Pi 3 Model A+/ B+ 
WAZNE: PROSIMY ZACHOWAG TE 
INFORMACJE NA PRZYSZŁOŚĆ. 


Ostrzeżenia 
Wszelkie zewnętrzne źródła zasilania 
używane z Raspberry Pi powinny być zgodne 
z odpowiednimi przepisami i normami 
obowiązującymi w kraju przeznaczenia. 
Zasilacz powinien zapewniać napięcie 5V DC 
i minimalny prąd znamionowy 2,5A. 

Instrukcje bezpiecznego użytkowania 

+ Ten produkt nie powinien być przetaktowany. 
Nie należy wystawiać tego produktu na 
działanie wody ani wilgoci, ani umieszczać go 
na powierzchni przewodzącej podczas pracy. 
Nie należy wystawiać tego produktu na 
działanie ciepła z jakiegokolwiek źródła; 
produkt zaprojektowano tak, aby działał 
niezawodnie w normalnej temperaturze 
pokojowej. 
Używać w dobrze wentylowanym otoczeniu i 
nie zakrywać podczas użytkowania. 
Podczas użytkowania należy 
umieścić produkt na stabilnej, płaskiej, 
nieprzewodzącej powierzchni i nie dopuścić 
do kontaktu z przedmiotami przewodzącymi 
prąd. 
Należy zachować ostrożność podczas 
obchodzenia się z produktem, aby uniknąć 
mechanicznego lub elektrycznego 
uszkodzenia płyty z obwodami drukowanymi 
i złączy. 
Nie należy przenosić produktu, gdy jest 
podłączony do zasilania. Trzymać wyłącznie 
za krawędzie, aby zminimalizować 
ryzyko uszkodzenia w wyniku wyładowań 
elektrostatycznych. 
Wszelkie urządzenia peryferyjne lub 
sprzęt używany z Raspberry Pi powinny 
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być zgodne z odpowiednimi normami 
dla kraju użytkowania i być odpowiednio 
oznakowane, aby zapewnić spełnienie 
wymagań bezpieczeństwa i wymogów 
eksploatacyjnych. 
Wszystkie certyfikaty zgodności i numery 
można znaleźć na stronie www.raspberrypi.org/ 
compliance. 


Português do Brasil 


Raspberry Pi 3 Modelo A+/ B + 
IMPORTANTE: POR FAVOR, GUARDE ESTAS 
INFORMAÇÕES PARA REFERÊNCIA FUTURA. 


Avisos 
Qualquer fonte de alimentação externa 
usada com o Raspberry Pi deve cumprir os 
regulamentos e normas aplicáveis no país 
de utilização. A fonte de alimentação deve 
fornecer 5V CC e uma corrente nominal 
mínima de 2,5A. 

Instruções para o uso seguro 

+ Este produto não deve ser usado em 
overclock. 
Não exponha este produto à água ou a 
umidade, e não o coloque em uma superficie 
condutora durante a operação. 
Näo exponha este produto ao calor de 
qualquer fonte; Ele é projetado para operação 
confiável à temperatura ambiente. 
Opere este produto em um ambiente bem 
ventilado e não o cubra durante o uso. 
Coloque este produto em uma superfície 
estável, plana e não condutora durante o 
uso, e não deixe que entre em contato com 
dispositivos que conduzem eletricidade. 
Tome cuidado ao manusear este produto 
para evitar danos mecânicos ou elétricos à 
placa de circuito impresso e aos conectores. 
Evite manusear este produto enquanto 
estiver ligado. Somente manuseie pelas 
bordas (laterais) para minimizar o risco de 
dano por descarga eletrostática. 
Qualquer periférico ou equipamento usado 
com o Raspberry Pi deve cumprir os padrões 
de fabricação e uso relevantes para o 
país e assim garantir que os requisitos de 
segurança e desempenho sejam atendidos. 

Para todos os certificados conformidade 

e números, visite www.raspberrypi.org/ 

compliance. 
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Raspberry Pi 3 Mogenb A+/ B+ 
BA)KHO: COXPAHUTE 3TY AHBOPMALINIO 
AIA BYAYLUETO UCNONb3OBAHMA. 


BHumanne! 

1060 BHELLIHNÜ NCTOYHNK NNTAHMA, 
ncnonb3yembiň c Raspberry Pi, Donven 
COOTBETCTBOBATb COOTBETCTBYIOLLIUM 
HOpMaM N CTaHAapTaM, TIPNMEeHREMbIM B 
CTPaHe npegnonaraemoro ucnonb30BaHuA. 
VICTOYHuK TINTaHMA Donen O6ecnieyuNBaTb 
5 B MOCTOAHHOTO TOKa U MUHUMANbHbIÜ 
HOMUHAYIbHbIN TOK 2,5 A. 

EB MN no 6esonacHomy UCNOJIb30BAHNIO 
ITOT NPosyKT He AOMKEH UCNOsb30BaTbCA 
Bonpeku HOPMaTUBaM NpONZOAMTENA. 

He nogpepraiite 3TOT nPoAyKT 
BO3AeÜCTBNI POD) WM BNATN N He 
pazmeuyaiite ero Ha NPOBOAALWIEN 
MOBEPXHOCTN BO BpemaA Pa60TbI. 

He nogpepraiite 3TOT nPoAyKT 
BO3AeÜCTBNM Tenna n3 DIODOFO NCTOYHNKA; 
OH NpegHa3HayeH Da HAAEKHOÑ pa6oTbi 
npr HOpManbHOÑ KOMHATHON Temnepatype. 
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OkcnnyaTupyiite STOT NPOAYKT B XOPOLIO 
MPOBETPNBaeMoN Cpepe n He HakpbIBaiiTe 
ero BO BPeMA NCNONb3OBAHMA. 
Nomectute 3TOT NpOAYKT Ha yCTOÑYNBYIO, 
MNOCKYIO, HEMPOBOAALLIYHO NOBEPXHOCTb BO 
BPEeMA NCNONb3OBAHNA N He NOSBONAÑTE 
eMy KOHTAKTNPOBATBb C NPOBOAALLINMU 
v3genuamn. 
Co6ntopaiite OCTOPO)KHOCTB Npr 
o6paųeHnn c 3TUM MIPOAyKTOM, 
UTO6bI N36E)KaTb MEXAHNYECKOTO NNN 
ƏNEKTpPNYECKOTO NOBPEKAEHNA NeYaTHOÑ 
DST n Pa3beMoB. 
U36eraite o6palueHua C 3TUM DDODWKTOM 
BO Bpema ero nuTaHua. Vicnonb3yiite 
TONbKO Kpas, YTO6bI CBECTN K MNHNMYMY 
Puck NOBperKAeHNA INEKTpPOCTATNYECKOTO 
paspaga. 
J1060e nepudepniiHoe yctpoiicTBo 
nnn O60PynoBaHne, NCNONb3yeMOe C 
Raspberry Pi, AOMKHO COOTBETCTBOBATb 
COOTBETCTBYHOLLINM CTaHJapTaM 
ANA CTPaHbI NCNONb3OBAHMA N ÖbITb 
COOTBETCTBYIOLIIUM 06Pa30M MapKNpOBaHO 
Ana o6ecneyeHna co6ntopeHua Tpe6oBaHui 
6e30NaCHOCTH N MIPON3BOAMTENbHOCTN. 
Ana Bcex ceptudukaToB COOTBETCTBUN N 
HOMEPOB, No>KanyiicTa, NOCETUTE WWW. 
raspberrypi.org/compliance . 


Espanol 


Raspberry Pi 3 Modelo A+/ B+ 
IMPORTANTE: POR FAVOR CONSERVE ESTA 
INFORMACION PARA FUTURA REFERENCIA. 


Advertencias 
Cualquier fuente de alimentaciön externa 
utilizada con la Raspberry Pi debera cumplir 
con las correspondientes regulaciones y 
normas aplicables en el pais de uso previsto. 
La fuente de alimentaciön debe proporcionar 
5V DC y una corriente nominal minima de 
2.5A. 

Instrucciones para un uso seguro 

+ Este producto no debe ser usado con una 
frecuencia de reloj superior a la nominal. (No 
se debe overclockear). 
No exponga este producto al agua o a 
la humedad, y no lo coloque sobre una 
superficie conductora mientras esta en 
funcionamiento. 
No exponga este producto a ningún tipo 
de fuente de calor; esta disefiado para 
un funcionamiento fiable a temperatura 
ambiente normal. 
Utilice este producto en un ambiente bien 
ventilado, y no lo cubra durante el uso. 
Coloque este producto sobre una superficie 
estable, plana y no conductora mientras esté 
en uso, y no permita que entre en contacto 
con elementos conductores. 
Tenga cuidado al manipular este producto 
para evitar dafios mecänicos o eléctricos 
en la placa de circuito impreso y en los 
conectores. 
Evite manipular este producto mientras esta 
encendido. Sujételo solo por los bordes para 
minimizar el riesgo de dafios por descargas 
electrostaticas. 
Cualquier periférico o equipo utilizado con la 
Raspberry Pi debe cumplir con las normas 
aplicables en el país de uso y debe estar 
marcado en consecuencia para garantizar 
que se cumplen los requisitos de seguridad 
y rendimiento. 

Para obtener todos los certificados de 

conformidad y sus números de registro, visite 

www.raspberrypi.org/compliance. 
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Svenska 


Raspberry Pi 3 Modell A+/ B + 
VIKTIGT: BEHALL DENNA INFORMATION FOR 
FRAMTIDA REFERENS. 


Varningar 

+ Alla externa strömförsörjningar som 
används med Raspberry Pi måste uppfylla 
alla tillämpliga regler och standarder i det 
land dar de används. Strömförsörjningen 
maste tillhandahälla 5 VDC och ha en lägsta 
märkström pa 2,5 A. 

Instruktioner for säker användning 
Produkten bör inte överklockas. 
Utsätt inte produkten för vatten eller fukt, och 
placera den inte pa en ledande yta medan 
den ar i drift. 
Utsätt inte produkten för värme fran någon 
värmekälla. Den är utformad för tillförlitlig 
drift vid normal rumstemperatur. 
Använd produkten i en väl ventilerad miljö, 
och täck inte över den vid användning. 
Placera produkten på en stabil, isolerad yta 
vid användning, och låt den inte komma i 
kontakt med ledande föremål. 
Var försiktig när du hanterar produkten för att 
undvika mekaniska eller elektriska skador på 
kretskortet och kontakterna. 
Undvik att hantera produkten med strömmen 
på. Håll den endast i kanterna för att undvika 
elektrostatiska urladdningar. 
Eventuell kringutrustning och utrustning 
som används med Raspberry Pi måste 
uppfylla relevanta standarder i det land där 
den används, och den bör märkas så att 
säkerhets- och prestandakraven uppfylls. 

Besök www.raspberrypi.org/compliance, för alla 

certifikat och nummer om överensstämmelse. 


EU 
Radio Equipment Directive (2014/53/EU) 
Declaration of Conformity (DoC) 


We, Raspberry Pi (Trading) Limited, 30 Station 
Road, Cambridge, CB1 2JH, United Kingdom, 
Declare under our sole responsibility that the 
product: Raspberry Pi 3 Model B+ to which 
this declaration relates is in conformity with 
the essential requirements and other relevant 
requirements of the Radio Equipment Directive 
(2014/53/EU). 


The product is in conformity with the following 
standards and/or other normative documents: 


SAFETY (art 3.1.a): IEC 60950-1: 2005 (2nd 
Edition) and EN 62311: 2008 EMC (art 3.1.b): EN 
301 489-1/ EN 301 489-17 Ver. 3.1.1 (assessed 
in conjunction with ITE standards EN 55032 and 
EN 55024 as Class B equipment) SPECTRUM 
(art 3. 2): EN 300 328 Ver 2.1.1, EN 301 893 
V2.1.0 


In accordance with Article 10.8 of the Radio 
Equipment Directive: The device ‘Raspberry 
Pi 3 Model B+’ operates in compliance with 
harmonised standard EN 300 328 v2.1.1 and 
transceives within the frequency band 2,400 
MHz to 2,483.5 MHz and, as per Clause 4.3.2.2 
for wideband modulation type equipment, 
operates at a maximum e.i.r.p. of 20dBm. 
The device ‘Raspberry Pi 3 Model B+’ also 
operates in compliance with harmonised 
standard EN 301 893 V2.1.1 and transceives 
within the frequency bands 5150-5250MHz, 
5250-5350MHz, and 5470-5725MHz and, as 
per Clause 4.2.3.2 for wideband modulation 


type equipment, operates at a maximum e.i.r.p. 
of 23dBm (5150-5350MHz) and 30dBm (5450- 
5725MHz). 


In accordance with Article 10.10 of the Radio 
Equipment Directive, and as per below list 

of country codes, the operating bands 5150- 
5350MHz are strictly for indoor usage only. 


The Raspberry Pi complies with the relevant 
provisions of the RoHS Directive for the 
European Union. 


WEEE Directive Statement for the European 
Union 

This marking indicates that this product 

should not be disposed with other household 
wastes throughout the EU. To prevent possible 
harm to the environment or human health 

from uncontrolled waste disposal, recycle it 
responsibly to promote the sustainable reuse of 
material resources. To return your used device, 
please use the return and collection systems 

or contact the retailer where the product was 
purchased. They can take this product for 
environmental safe recycling. Note: A full online 
copy of this Declaration can be found at www. 
raspberrypi.org/compliance/ 


China 
Raspberry Pi 3 Model B+ CMIIT ID: 2018AJ2147 


FCC 


Raspberry Pi 3 Model B+ FCC ID: 2ABCB-RPI3BP 
Model A+ FCC ID:2ABCB-RPI3AP 


This device complies with Part 15 of FCC Rules, 
Operation is Subject to following two conditions: 
(1) This device may not cause harmful 
interference, and (2) This device must accept 
any interference received including interference 
that cause undesired operation. Caution: Any 
changes or modifications to the equipment not 
expressly approved by the party responsible 

for compliance could void user s authority to 
operate the equipment. This equipment has been 
tested and found to comply within the limits 

for a Class B digital device, pursuant to part 15 
of the FCC Rules. These limits are designed to 
provide reasonable protection against harmful 
interference in a residential installation. This 
equipment generates, uses, and can radiate radio 
frequency energy and, if not installed and used 
in accordance with the instructions, may cause 
harmful interference to radio communications. 
However, there is no guarantee that interference 
will not occur in a particular installation. If this 
equipment does cause harmful interference 

to radio or television reception, which can be 
determined by turning the equipment off and 

on, the user is encouraged to try to correct the 
interference by one or more of the following 
measures: + Reorient or relocate the receiving 
antenna + Increase the separation between the 
equipment and receiver 


« Connect the equipment into an outlet ona 
different circuit from that to which the receiver 
is connected - Consult the dealer or an 
experienced radio/TV technician for help. For 
product available in the USA/Canada market, 
only channel 1~11 can be operated and these 
channel assignments deal with only the 2.4GHz 
range This device and its antenna(s) must 
not be co-located or operation in conjunction 
with any other antenna or transmitter except 
in accordance with FCC's multi-transmitter 
procedures. This device is going to be operated 
in 5.15~5.25GHz frequency range, it is restricted 
in indoor environment only 
IMPORTANT NOTE: FCC Radiation Exposure 
Statement; This appliance and its antenna must 
not be co-located or operation in conjunction 
with any other antenna or transmitter. A 
minimum separation distance of 20cm must be 
maintained between the antenna and the person 
for this appliance to satisfy the RF exposure 
requirements. This raspberry Pi product is 
certified for usage as a Single Module under 
the requirements of 15.212. The integration of 
this module into end products is subject to the 
following requirements: 
USER MANUAL OF THE END PRODUCT: 
In the user's manual of the end of product, the 
end user has to be informed: 
To keep at least 20cm separation with the 
antenna while this end product is installed 
and operated. 
That the FCC radio-frequency exposure 
guidelines for an uncontrolled environment 
can be satisfied. 
That any changes or modifications not 
expressly approved by the manufacturer 
could void the user's authority to operate this 
equipment. 
That, if the size of the end product is smaller 
than 8x10cm, then additional FCC part15.19 
statement is required to be available in the 
user's manual; This device complies with 
Part 15 of FCC Rules, Operation is Subject 
to following two conditions: (1) This device 
may not cause harmful interference, and (2) 
This device must accept any interference 
received including interference that cause 
undesired operation. Caution: Any changes 
or modifications to the equipment not 
expressly approved by the party responsible 
for compliance could void user's authority to 
operate the equipment. 


LABEL OF THE END PRODUCT: 

The final end product must be labelled in a 
visible area with the following " Contains TX 

FCC ID: 2ABCB-RPI3A/BP". If the size of the end 
product is larger than 8x10cm, then the following 
FCC part 15.19 statement has to also be 
available on the label: This device complies with 
Part 15 of FCC rules. Operation is subject to the 
following two conditions: (1) this device may not 
cause harmful interference and (2) this device 
must accept any interference received, including 
interference that may cause undesired operation. 


ISED 


Raspberry Pi 3 Model B+ IC: 20953-RPI3P 
Raspberry Pi 3 Model A+ IC:20953-RPI3A 

This device complies with Industry Canada 
license-exempt RSS standard(s). Operation is 
subject to the following two conditions: (1) this 
device may not cause interference, and (2) this 
device must accept any interference, including 
interference that may cause undesired operation 
of the device. 


Le présent appareil est conforme aux CNR 
d'Industrie Canada applicables aux appareils 
radio exempts de licence. L'exploitation est 
autorisée aux deux conditions suivantes :(1) 
l'appareil ne doit pas produire de brouillage, et 
(2) l'utilisateur de l'appareil doit accepter tout 
brouillage radioélectrique subi, méme si le 
brouillage est susceptible den compromettre le 
fonctionnement. 


For product available in the USA/Canada market, 
only channel 1~11 can be operated. Selection of 
other channels is not possible. 

Pour les produits disponibles aux Etats-Unis / 
Canada du marché, seul le canal 1 à 11 peuvent 
être exploités. Sélection d'autres canaux nest 
pas possible. 


This device and its antenna(s) must not be 
co-located with any other transmitters except 

in accordance with IC multi-transmitter product 
procedures. Referring to the multi-transmitter 
policy, multiple-transmitter(s) and module(s) 
can be operated simultaneously without 
reassessment permissive change. Cet appareil 
et son antenne (s) ne doit pas étre co-localisés 
ou fonctionnement en association avec une 
autre antenne ou transmetteur. This radio 
transmitter has been approved by Industry 
Canada to operate with the antenna types listed 
below with the maximum permissible gain 
indicated. Antenna types not included in this list, 
having a gain greater than the maximum gain 
indicated for that type, are strictly prohibited 

for use with this device.Le présent émetteur 
radio (IC: 20953-RPI3P) a été approuve par 
Industrie Canada pour fonctionner avec les types 
d'antenne énumérés ci-dessous et ayant un 
gain admissible maximal d'antenne. Les types 
d'antenne non inclus dans cette liste, ou dont 

le gain est supérieur au gain maximal indique, 
sont strictement interdits pour l'exploitation de 
l'émetteur. 


Dynamic Frequency Selection (DFS) for devices 
operating in the bands 5250- 5350 MHz, 
5470-5600 MHz and 5650-5725 MHz. Sélection 
dynamique de fréquences (DFS) pour les 
dispositifs fonctionnant dans les bandes 5250- 
5350 MHz, 5470-5600 MHz et 5650-5725 MHz. 
The device for operation in the band 5150-5250 
MHz is only for indoor use to reduce the potential 
for harmful interference to co-channel mobile 
satellite systems. les dispositifs fonctionnant 
dans la bande 5150-5250 MHz sont réservés 
uniquement pour une utilisation a l'intérieur afin 
de réduire les risques de brouillage préjudiciable 
aux systèmes de satellites mobiles utilisant les 
mémes canaux. The maximum antenna gain 
permitted for devices in the bands 5250-5350 
MHz and 5470-5725 MHz shall be such that 

the equipment still complies with the e.i.r.p. 
limit.le gain maximal d'antenne permis pour les 
dispositifs utilisant les bandes 5250-5350 MHz 
et 5470-5725 MHz doit se conformer a la limite 
de p.i.re. 


The maximum antenna gain permitted for 
devices in the band 5725-5850 MHz shall be 
such that the equipment still complies with the 
e..r.p. limits specified for point-to-point and non- 
point-to-point operation as appropriate. 

le gain maximal d'antenne permis (pour les 
dispositifs utilisant la bande 5725-5850 MHz) 
doit se conformer a la limite de p.i.r.e. spécifiée 
pour l'exploitation point a point et non point a 
point, selon le cas. For indoor use only. Pour une 
utilisation en intérieur uniquement. 


IMPORTANT NOTE: 

IC Radiation Exposure Statement: 

This equipment complies with IC RSS-102 
radiation exposure limits set forth for an 
uncontrolled environment. This equipment 
should be installed and operated with minimum 
distance 20cm between the radiator & your body. 
Cet équipement est conforme aux limites 
d'exposition aux rayonnements IC établies pour 
un environnement non contröle. Cet &quipement 
doit étre installé et utilisé avec un minimum 

de 20 cm de distance entre la source de 
rayonnement et votre corps. 


IMPORTANT NOTE: 

This module is intended for OEM integrator. The 
OEM integrator is responsible for the compliance 
to all the rules that apply to the product into 
which this certified RF module is integrated. 
Additional testing and certification may be 
necessary when multiple modules are used. 

Any changes or modifications not expressly 
approved by the manufacturer could void the 
user's authority to operate this equipment. 


USERS MANUAL OF THE END PRODUCT: 

In the user's manual of the end product, the end 
user has to be informed to keep at least 20cm 
separation with the antenna while this end 
product is installed and operated. The end user 
has to be informed that the IC radio-frequency 
exposure guidelines for an uncontrolled 
environment can be satisfied 


The end user has to also be informed that 

any changes or modifications not expressly 
approved by the manufacturer could void the 
user's authority to operate this equipment. 
Operation is subject to the following two 
conditions: (1) this device may not cause harmful 
interference and (2) this device must accept any 
interference received, including interference that 
may cause undesired operation. 


LABEL OF THE END PRODUCT: 

The final end product must be labelled in a 
visible area with the following " Contains IC: 
20953-RPI3P / 20953-RPI3A ".The Host Model 
Number (HMN) must be indicated at any 
location on the exterior of the end product or 
product packaging or product literature which 
shall be available with the end product or online. 


Australia and New Zealand 


Class B Emissions Compliance Statement 
Warning: This is a Class B product. In a domestic 
environment this product may cause radio 
interference in which case the user may be 
required to take adequate measures. 


Brazil 


Este equipamento não tem direito à proteção 
contra interferência prejudicial e não pode 
causar interferência em sistemas devidamente 
autorizados. Este produto está homologado 
pela Anatel, de acordo com os procedimentos 
regulamentados pela Resolução n°242/2000 

e atende aos requisitos técnicos aplicados, 
incluindo os limites de exposição da Taxa 

de Absorção Específica referente a campos 
elétricos, magnéticos e eletromagnéticos de 
radiofrequência, de acordo com as Resoluções 
n° 303/2002 e 533/2009. 


Mexico 


La operación de este equipo está sujeta a las 
siguientes dos condiciones: (1) es posible que 
este equipo o dispositivo no cause interferencia 
perjudicial y (2) este equipo o dispositivo debe 
aceptar cualquier interferencia, incluyendo la 
que pueda causar su operación no deseada. 
Este equipo esta diseñado para operar con las 
antenas que enseguida se enlistan y para una 
ganacia máxima de 3.5 dBi. El uso de Antenas 
con este equipo no incluidas en esta lista o que 
tengan una ganancia mayor a 3.5 dBi quedan 
PROHIBIDAS. 


Taiwan 
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SUBSCRIPTION 


SUBSCRIBE TODAY 
FROM ONLY £5 


ÙP T6 30 /o 


» FREE Delivery 
Get it fast and for FREE 


» Exclusive Offers 

Great gifts, offers, and discounts 
> Great Savings 

Save up to 35% compared to stores 


> Low monthly cost (from £5) 
» Cancel at any time 

» Free delivery to your door 
» Available worldwide 


£55 (UK) £90 (USA & Rest of World) 
£80 (EU) 


Free Raspberry Pi Zero W Kit with 12 Month upfront 
subscription only (no Raspbery Pi Zero Kit with Rolling 


Monthly Subscription) 


© Subscribe by phone: 01293 312193 
© Subscribe online: magpi.cc/subscribe 


Email: magpi@subscriptionhelpline.co.uk 


JOIN FOR 12 MONTHS AND GET A 
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Raspberry Pi 
Zero W case with 
three covers 
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converter cables 


Camera Module 
connector 


Offer subject to change or 
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wit RASPBERRY PI 


The world’s favourite single-board computer, Raspberry Pi is packed with 
potential: it can be a digital camera, a programmable games machine, 
or even a sensor for the International Space Station. While creating a 
Raspberry Pi project, you’ll learn computing, coding, and electronics. 

It’s fun, and creative, and it’s changing the world. 


> Set up your Raspberry Pi 3A+ for the first time 
> Discover amazing software built for creative learning 
> Learn how to program in Scratch and Python 


> Control electronics: buttons, lights, and sensors 
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magpi.cc 


Not to be sold separately 


